Delete an uploaded file
Deletes a file you uploaded from your account's workspace: every version of it, and everything derived from it (parse outputs, search-index entries). It can't be undone; jobs that already ran keep their results until those expire. Free, and works at any balance.
The answer waits for the deletion to finish: 200 with status: "deleted" once every trace is confirmed gone, or 202 with status: "deleting" if it is still running. Send the same request again to check on it.
Other errors (500, 502, 503, 504, 529) are on Errors.
Authorization
bearerAuth Your API key from the dashboard's API Keys page: nace_sk_ followed by 43 URL-safe characters (A-Z, a-z, 0-9, _ and -), shown once when you create it. Send it as Authorization: Bearer nace_sk_... Any other value returns 401 authentication_error. An account can hold at most 3 active keys.
In: header
Path Parameters
The file's workspace_id, as an upload returned it. Only your account's workspace.
uuidThe file's file_id, as an upload returned it.
uuidResponse Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X DELETE "https://example.com/v1/documents/workspaces/497f6eca-6276-4993-bfeb-53cbbbba6f08/files/497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "object": "file_deletion", "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9", "file_id": "8a0cfb4f-ddc9-436d-91bb-75133c583767", "status": "deleted"}