---
title: "Delete a file"
method: DELETE
path: "/v1/files/{id}"
tags: ["Files"]
---

# Delete a file

`DELETE /v1/files/{id}`

## Request

- Base URL: `https://api.tryleap.ai`
- URL: `https://api.tryleap.ai/v1/files/{id}`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Deletes a file you uploaded, and its bytes. Runs that already used it keep their results, and their `input` still names the deleted ID. A file that points at a run's result, such as one made from an output to pass to another model, loses only its file ID: the run keeps its result. Answers `409 file_in_use` while a run that hasn't finished takes the file, or while it is someone's saved photo.

Needs an API key with the `generations:write` scope.

## Path parameters

- `id` string, required: The file's ID, `file_...`.

## Response `200`

The deleted file's ID.

- DeletedFile
  - `id` string, required: The deleted file's ID.
  - `object` 'file', required
  - `deleted` true, required

## Other responses

- `400`: `conflicting_credentials`
- `401`: `authentication_required`
- `403`: `permission_denied`
- `404`: `resource_not_found`
- `409`: `file_in_use`
- `429`: `rate_limit_exceeded`

---

[API](https://skmtc.dev/tryleap/apis/leap-api.md) · [All operations](https://skmtc.dev/tryleap/apis/leap-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tryleap/apis/leap-api/revisions/c01f98d3e835?raw)