# Acknowledge a repo's failed or finished upload so the feed stops reporting it

`POST /v1/datasets/uploads/{repo_id}/dismiss`

Dismiss, not destroy: QDS records a per-repo watermark that suppresses
the repo's terminal entries (`failed` and `finalized`, and the quiet
`staging` rows a failure falls back to) at or older than the entry the
caller saw. The failure record itself
is kept — it is the only account of why the ingest failed — and no storage
is reclaimed. A live upload cannot be dismissed: `preparing`/`publishing`
are never suppressed, and `staging` only after the transfer has stopped
taking new manifests, so a click that races a running attempt returns the
live phase instead of hiding it.

A sub-resource of the feed it edits, not of `/datasets/{dataset_id}`: a
failed upload has minted no dataset. POST rather than DELETE for the same
reason — nothing is deleted, and it carries a body.

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

## Parameters

- `repo_id` (path, string (uuid), required)
- `account_id` (query, string | null (uuid)): Act on this account (active)

## Request body

Required: `application/json` `DismissUploadBody`

## Responses

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

## Schemas

```yaml
DismissUploadBody:
  properties:
    dismissed_through_unix:
      type: integer
      minimum: 0
      default: 0
  additionalProperties: false
  type: object
  title: DismissUploadBody
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
```