Developers
Files

Retrieve a file

GET/files/{file_id}

Retrieves a file by its public ID, including its content type and SHA-256 checksum.

Authorization

AuthorizationBearer <token>

Autonomous mode: the API credential secret, sent as a bearer token. Credential secrets are identified by a fixed prefix.

In: header

Path Parameters

file_id*string

Header Parameters

X-Client-Request-Id?string

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.

Lengthlength <= 64

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/files/string"
{  "data": {    "checksum": {      "md5": "string",      "sha256": "string"    },    "content_type": "string",    "created_at": "2019-08-24T14:15:22Z",    "extension": "string",    "filename": "string",    "id": "string",    "object": "file",    "purpose": "string",    "size_bytes": 0,    "status": "ready"  }}

List files GET

Lists the files stored in the current account, using cursor-based pagination. Results are sorted by creation date, newest first. The collection can be filtered by purpose and by creation date range.

Delete a file DELETE

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.