Developers
Files

Create a download link

POST/files/{file_id}/download-links

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.

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.

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

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/files/string/download-links" \  -H "Content-Type: application/json" \  -d '{}'
{  "data": {    "expires_at": "2019-08-24T14:15:22Z",    "method": "GET",    "object": "download_link",    "url": "string"  }}

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.

Uploads

Next Page