# Datasets_DeleteDataset

`DELETE /v1/accounts/{account}/datasets/{dataset}`

Deletes a mixture, or retires an upload or a merged dataset: it leaves
every list and its episodes leave every mixture, but nothing is erased,
and versions that pin its episodes keep resolving. A merged dataset is
retired with the uploads it holds, which then answer
NOT_FOUND; an upload bound to append to it that it does not hold (not
appended yet, or taken back out before merges were final) is unbound.
Refused with FAILED_PRECONDITION while another mixture reads it by name
(for a merged dataset, also a pin of one of its uploads' tags; any other
source left on one of them reads nothing and does not hold it); a
mixture that reads it through a label source stops reading it. An upload
merged into another is not deleted on its own (FAILED_PRECONDITION naming
the merged dataset). A dataset whose episodes are references of Tasks
(Dataset.task_references) is refused too unless sent with force, which
removes those references.

- 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.
- `etag` (query, string): The dataset's current etag, when the caller wants the guard.
- `force` (query, boolean): Delete it even though its episodes are references of Tasks
  (Dataset.task_references), removing those references; the Tasks stay.
  Without it, such a dataset is refused (FAILED_PRECONDITION). Reingests
  and the ingest report live under uploads and are never deleted here.

## Responses

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

## Schemas

```yaml
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.
```