# Datasets_GetReingest

`GET /v1/accounts/{account}/datasets/{dataset}/reingests/{reingest}`

Where a re-ingest has got to, from durable state. It never retries or
cancels the work. One step it does take: a re-ingest whose ingest
committed while the server coordinating it was replaced is published by
the read that finds it.

- Base URL: `https://junction-api.qualiastudios.dev`
- Authentication: an API key in the `X-API-Key` header

## Parameters

- `account` (path, string, required): The account id.
- `dataset` (path, string, required): The dataset id.
- `reingest` (path, string, required): The reingest id.

## Responses

- `200` OK: `application/json` `qualia.v1.Reingest`
- `default` Default error response: `application/json` `google.rpc.Status`

## Schemas

```yaml
qualia.v1.Reingest:
  type: object
  properties:
    name:
      type: string
      description: accounts/{account}/datasets/{dataset}/reingests/{reingest}
    state:
      readOnly: true
      enum:
        - STATE_UNSPECIFIED
        - QUEUED
        - PREPARING
        - PUBLISHING
        - SUCCEEDED
        - FAILED
      type: string
      description: Where the work stands.
      format: enum
    unchanged:
      readOnly: true
      type: boolean
      description: |-
        The posted config was the published one: nothing ran, and this names
        the publication that already carries it.
    failureReason:
      readOnly: true
      type: string
      description: Why it failed; empty unless FAILED.
    progress:
      readOnly: true
      type: object
      description: |-
        While PREPARING: the live step, the same open set of fields the upload
        feed reports (step, detail, counters).
    episodeCount:
      readOnly: true
      type: string
      description: "Once SUCCEEDED: episodes in the published generation."
    frameCount:
      readOnly: true
      type: string
      description: "Once SUCCEEDED: frames in the published generation."
    poseAttempt:
      readOnly: true
      type: integer
      description: Attempt currently preparing a pose move, or zero when cancellation is unavailable.
      format: int32
    publicationFailure:
      readOnly: true
      type: string
      description: Most recent safe publication failure while publishing, if any.
    recutResult:
      readOnly: true
      allOf:
        - $ref: "#/components/schemas/qualia.v1.ReingestRecutResult"
      description: |-
        Present only when a verified re-cut result committed atomically with
        this successful publication. Absence is not an empty/clean result.
  description: |-
    One re-ingest of an upload under a new meta/ingest.toml
    (Datasets.ReingestDataset).
qualia.v1.ReingestRecutResult:
  type: object
  properties:
    notCarriedCount:
      readOnly: true
      type: string
      description: |-
        Exact number of old original takes with state not carried. Zero means
        the verified publication lost no state; no such take is listed.
    publicationCommit:
      readOnly: true
      type: string
      description: Immutable publication commit, used to bind every page of the result.
  description: Summary of state not carried by one verified, finalized re-cut publication.
google.rpc.Status:
  oneOf:
    - $ref: "#/components/schemas/ApiError"
    - $ref: "#/components/schemas/GatewayError"
  description: "The body of a failed call: one of the two shapes below."
ApiError:
  title: API error
  type: object
  required:
    - code
    - message
    - retryable
    - details
  properties:
    code:
      type: string
      description: The gRPC code name in upper case, e.g. `NOT_FOUND`.
    message:
      type: string
    retryable:
      type: boolean
      description: Whether the same call may succeed if retried.
    details:
      type: array
      items:
        type: object
      description: "Empty, except when a dataset copy or move is refused: then one `google.rpc.ErrorInfo` with the refusal's `reason` code, its `domain` and, in `metadata`, the datasets it names."
  description: A refusal from the API itself.
GatewayError:
  title: Gateway error
  type: object
  required:
    - detail
  properties:
    detail:
      type: string
      description: What went wrong.
  description: A refusal from the gateway before the call reaches the API, for example `401` bad or missing API key, `403` key lacks the scope or environment closed, `413` body too large.
```