JavaScript SDK

await client.files.getDownloadUrls([{id: 123}, {externalId: 'abc'}]);

{
  "items": [
    {
      "downloadUrl": "<string>",
      "id": 4503599627370496
    }
  ]
}

Download files

Required capabilities: filesAcl:READ

Or dataModelsAcl:READ (scope spaceId: cdf_cdm) and dataModelInstancesAcl:READ

Retrieves a list of download URLs for the specified list of file IDs. After getting the download links, the client has to issue a GET request to the returned URLs, which will respond with the contents of the file. The links will by default expire after 30 seconds. If providing the query parameter extendedExpiration the links will expire after 1 hour.

Request throttling

Please note that this endpoint is subject to the new throttling policy, which imposes limits on both request rate and concurrency. For more details, please refer to the Files resource documentation.

POST

files

downloadlink

JavaScript SDK

await client.files.getDownloadUrls([{id: 123}, {externalId: 'abc'}]);

{
  "items": [
    {
      "downloadUrl": "<string>",
      "id": 4503599627370496
    }
  ]
}

Authorizations

Authorization

string

header

required

Access token issued by the CDF project's configured identity provider. Access token must be an OpenID Connect token, and the project must be configured to accept OpenID Connect tokens. Use a header key of 'Authorization' with a value of 'Bearer $accesstoken'. The token can be obtained through any flow supported by the identity provider.

Query Parameters

extendedExpiration

boolean

default:false

if set to true, will extend the expiration period of the link to 1 hour.

Body

application/json

List of file IDs to retrieve the download URL for.

items

object[]

required

Required array length: 1 - 100 elements

Option 1
Option 2
Option 3

Show child attributes

Response

The response for a successful files/downloadlink operation.

items

object[]

Option 1
Option 2
Option 3

Show child attributes

Last modified on June 2, 2026

Get upload file link

Upload multipart file

⌘I

Documentation Index

Authorizations

Query Parameters

Body

Response