Delete a file
/files/{file_id}Permanently deletes the file from storage and removes it from the account's file inventory. The file is not moved to the trash and cannot be restored.
If the storage service is unavailable, the file is not deleted and the request can be retried.
The Idempotency-Key header is optional for this operation.
Autonomous mode: the API credential secret, sent as a bearer token. Credential secrets are identified by a fixed prefix.
In: header
Path Parameters
Public ID of the file, prefixed with file_.
Header Parameters
Client-generated key that makes the request safe to retry. Must be 1 to 128 characters from [A-Za-z0-9._:-]. Optional on this operation; when sent, a malformed key returns idempotency_key_invalid, and repeating the request with the same key and the same body returns the stored result with Idempotent-Replayed: true.
Optional client-generated identifier of the request, up to 64 characters from [A-Za-z0-9._-]. Echoed back in the response and recorded in the request log; it never replaces the server-generated X-Request-Id.
length <= 64Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X DELETE "https://example.com/files/string"Retrieve a file GET
Retrieves a file by its public ID, including its content type and SHA-256 checksum.
Create a download link POST
Issues a short-lived, pre-signed URL for downloading the file. The link lifetime is set with `ttl_seconds`. When omitted, it defaults to the maximum of 900 seconds. Set `inline` to `true` to have the browser open the file instead of downloading it as an attachment (the default), and use `download_name` to set the file name the browser uses when saving it. This operation requires the `Idempotency-Key` header. Replaying a request with the same key returns the original response, including the original URL, which may already have expired. To obtain a valid link, send a new request with a different key.