# In-flight uploads for the caller's account

`GET /v1/datasets/uploads`

One QDS-owned pending-band feed, including the SDK transfer heartbeat.

The tenant is either the caller's bound account or a membership-verified
interactive active-account override; no second service or client-side
merge participates in the result.

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

## Parameters

- `account_id` (query, string | null (uuid)): Scope to this account (the dashboard's active account). Membership is verified before QDS reads its upload state.

## Responses

- `200` Successful Response: `application/json` `UploadOperationsResponse`
- `401` Invalid or missing API key: `application/json` `ErrorResponse`
- `422` Validation Error: `application/json` `HTTPValidationError`

## Schemas

```yaml
UploadOperationsResponse:
  properties:
    uploads:
      items:
        $ref: "#/components/schemas/UploadOperationModel"
      type: array
  type: object
  required:
    - uploads
  title: UploadOperationsResponse
UploadOperationModel:
  properties:
    repo_id:
      type: string
    name:
      type: string
    phase:
      type: string
    staging_manifests:
      type: integer
    staged_bytes:
      type: integer
    logical_bytes:
      type: integer
    updated_at_unix:
      type: integer
    transferred_bytes:
      type:
        - integer
        - "null"
    uploaded_bytes:
      type:
        - integer
        - "null"
    total_files:
      type:
        - integer
        - "null"
    staged_files:
      type:
        - integer
        - "null"
    message:
      type: string
      default: ""
    progress:
      nullable: true
      additionalProperties: true
      type: object
    phase_history:
      nullable: true
      additionalProperties: true
      type: object
    ingest_report:
      nullable: true
      additionalProperties: true
      type: object
    failure_retryable:
      type: boolean
      default: false
    dataset_id:
      type: string
      default: ""
    dataset_version_id:
      type: string
      default: ""
    generation:
      type: integer
      default: 0
    episode_count:
      type: integer
      default: 0
    total_frames:
      type: integer
      default: 0
    terminal_cause:
      type: string
      default: ""
    ingest_verdict:
      type: string
      default: ""
    verdict_reason:
      type: string
      default: ""
    cancellable:
      type: boolean
      default: false
  type: object
  required:
    - repo_id
    - name
    - phase
    - staging_manifests
    - staged_bytes
    - logical_bytes
    - updated_at_unix
  title: UploadOperationModel
ErrorResponse:
  properties:
    detail:
      type: string
      description: Error message describing what went wrong
  type: object
  required:
    - detail
  title: ErrorResponse
  description: Standard error response.
HTTPValidationError:
  properties:
    detail:
      items:
        $ref: "#/components/schemas/ValidationError"
      type: array
  type: object
  title: HTTPValidationError
ValidationError:
  properties:
    loc:
      items:
        type:
          - string
          - integer
      type: array
      title: Location
    msg:
      type: string
      title: Message
    type:
      type: string
      title: Error Type
    input: {}
    ctx:
      type: object
      title: Context
  type: object
  required:
    - loc
    - msg
    - type
  title: ValidationError
```