---
title: "Delete Media"
method: DELETE
path: "/v1/jobs/{job_id}/media"
tags: ["jobs"]
---

# Delete Media

`DELETE /v1/jobs/{job_id}/media`

## Request

- Base URL: `https://api.craterview.ai`
- URL: `https://api.craterview.ai/v1/jobs/{job_id}/media`
- Auth: HTTP bearer

Delete this job's pictures now — the copy of your image the job worked from, the
result, its preview, and any kept copy — rather than waiting for them to expire on
schedule. A job you shared leaves the gallery with them. The file you uploaded is not
part of the job: it is deleted on its own, shortly after the upload.

The job itself stays in your history, with what it cost and when it ran, but with no
pictures: reading it afterwards gives no links, exactly as an expired job does. Not
reversible, and safe to repeat: a second call, or a call on a job whose pictures have
already gone, is 204 as the first was. A job that is still queued or running cannot be
deleted until it settles.

## Path parameters

- `job_id` string, required

## Response `204`

Successful Response

## Other responses

- `400`: the path, query or a JSON string in the body contains a NUL character or an unpaired surrogate; the body is not JSON encoded as UTF-8, or carries a number JSON cannot represent (NaN, Infinity, or one too large) or nesting too deep to read; or an Idempotency-Key header is longer than 255 characters or not printable ASCII. The request was not read
- `401`: missing, malformed or unrecognised API key
- `404`: no job of yours with that id
- `409`: the job is still queued or running
- `413`: the request body is larger than 1 MiB. The request was not read
- `422`: Validation Error

---

[API](https://skmtc.dev/craterview/apis/craterview-ai-api.md) · [All operations](https://skmtc.dev/craterview/apis/craterview-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/craterview/apis/craterview-ai-api/revisions/9419a5cd27cd?raw)