Required capabilities:
filesAcl:READOr
dataModelsAcl:READ(scope spaceId:cdf_cdm) anddataModelInstancesAcl: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.
If the file was uploaded with a Content-Encoding set (either via the 'contentEncoding' field
in the create request body for multipart uploads, or via a 'Content-Encoding' header on the PUT uploadURL
request for single-part uploads), the GET response will include a 'Content-Encoding' header set to that value,
and the client is responsible for decompressing the content accordingly.
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.
List of file IDs to retrieve the download URL for.
required | Array of FileInternalId (object) or FileExternalId (object) or FileInstanceId (object) (FileIdEither) [ 1 .. 100 ] items |
The response for a successful files/downloadlink operation.
The response for a failed request.
{- "items": [
- {
- "id": 1
}
]
}{- "items": [
- {
- "downloadUrl": "string",
- "id": 1
}
]
}