Asteria Docs
Files

Delete File

Delete the row and release its claim on the bytes. The blob itself goes only when nothing else references it: another file in this org, a chat upload, or another tenant's copy of identical content. `release_reference` owns that decision. Deleting the object here would strand every other row pointing at it. NOTE: every docstring on a route in this module is **published**. The docs site generates a page per operation from the OpenAPI spec, and `docs-site/scripts/check-content.mjs` holds those pages to house style, so an em dash here fails the docs build rather than review.

DELETE
/v1/files/{file_id}
Authorization<token>

Your API key (sk-ast-...)

In: header

Path Parameters

file_id*File Id

Response Body

application/json

application/json

curl -X DELETE "https://example.com/v1/files/string"
{  "id": "string",  "object": "file",  "deleted": true}