Workspaces

Delete a workspace file

Other errors (500, 502, 503) are on Errors.

DELETE
/v1/workspaces/{id}/files/{file_id}

Other errors (500, 502, 503) are on Errors.

Authorization

bearerAuth
AuthorizationBearer <token>

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

idstringrequired

The workspace's workspace_id.

file_idstringrequired

The file's file_id.

Query Parameters

wait_secondsinteger

Hold the request open until the job finishes, up to this many seconds. 0 (default) returns at once; a value above 60 waits 60.

Range0 <= value

Header Parameters

Idempotency-Keystring

Up to 200 characters, unique per account. Retry with the same key and body to get the same job instead of a second one.

Lengthlength <= 200

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/v1/workspaces/string/files/string"
{  "job_id": "453bd7d7-5355-4d6d-a38e-d9e7eb218c3f",  "kind": "string",  "status": "queued",  "workspace_id": "string",  "result": null}