Perception
Delete an uploaded file
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.
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, sent as Authorization: Bearer nace_sk_...
- Where: the dashboard's API Keys page. It is shown once, when you create it.
- Format:
nace_sk_followed by 43 URL-safe characters (A-Z,a-z,0-9,_and-). - Limit: an account can hold at most 3 active keys.
- Wrong or missing key: returns
401 authentication_error.
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"}