Skip to content
Luma Agents
lumalabs.ai
API Reference
Files

Delete a file

DELETE/files/{file_id}

Delete a file. The file is deleted immediately and this cannot be undone through the API: it can no longer be retrieved, listed, or referenced from new generations. Where file retention is enabled for your API client, its stored bytes are then permanently deleted by a background job, not during this request, and stored bytes another live artifact still references are kept; otherwise the bytes stay stored until a Luma operator purges them. A failed file, or a file past its expires_at, can also be deleted until its stored bytes have been purged. Repeating DELETE returns 204 until the stored bytes have been purged, and 404 after that. Returns 204 with no body.

Path Parameters
file_id: string
format: uuid

Delete a file

curl https://agents.lumalabs.ai/v1/files/$FILE_ID \
    -X DELETE \
    -H "Authorization: Bearer $LUMA_AGENTS_API_KEY"