Delete File (each::storage)

Overview

Permanently deletes a file in your organization: one you uploaded with Upload File or one a model generated. Pass the file’s id, returned by the presign step for uploads and listed on the storage page for every file. A successful delete removes the stored object, so the file’s public_url stops resolving. Deletes are idempotent — deleting a file that’s already gone returns the same 204 No Content.

Endpoint

DELETE https://api.eachlabs.ai/v1/files/{id}

Path Parameters

Parameter	Type	Required	Description
`id`	string (UUID)	Yes	The file id: the `id` field of the Upload File presign response, or the File ID shown on the storage page.

Code Examples

curl -X DELETE https://api.eachlabs.ai/v1/files/0dce0f44-b8a5-4f30-91d4-5f6b0c221bf0 \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

resp = requests.delete(
    "https://api.eachlabs.ai/v1/files/0dce0f44-b8a5-4f30-91d4-5f6b0c221bf0",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(resp.status_code)  # 204 on success

const resp = await fetch(
  "https://api.eachlabs.ai/v1/files/0dce0f44-b8a5-4f30-91d4-5f6b0c221bf0",
  {
    method: "DELETE",
    headers: { "Authorization": "Bearer YOUR_API_KEY" },
  },
);
// resp.status === 204

Response

A successful delete returns 204 No Content with an empty body.

Error Responses

Status	Body	Description
`400`	`{"error": "invalid argument"}`	`id` is not a valid UUID.
`401`	`{}`	Missing or invalid API key.
`404`	`{"error": "file not found"}`	No such file in your organization.
`409`	`{"error": "conflict"}`	The file is still being processed and isn’t in a deletable state yet. Retry once the upload has finished.

Deletes are permanent and idempotent. A successful delete removes the stored object, so any public_url for the file stops resolving. Deleting a file that was already deleted, or an id that never existed, also returns 204.

Overview

Files

OpenAPI Reference

Delete File (each::storage)

Overview

Endpoint

Path Parameters

Code Examples

Response

Error Responses

​Overview

​Endpoint

​Path Parameters

​Code Examples

​Response

​Error Responses

Overview

Endpoint

Path Parameters

Code Examples

Response

Error Responses