Generate presigned URL for thumbnail download
POST
v2/hubs/{hubId}/collections/{collectionId}:get-download-url
Generates a presigned S3 URL for downloading a collection thumbnail image. Any user with read access to the collection can download the thumbnail.
End-to-end workflow:
- Confirm the collection exists and the caller has read access — GET /v2/hubs/A122B37C-D8CD-497C-9DF3-24971A4C17BB/collections/C652DFB6-2A4B-4AFC-8572-892DCCC3577F.
- Request the presigned URL, sending the standard Authorization header — POST /v2/hubs/A122B37C-D8CD-497C-9DF3-24971A4C17BB/collections/C652DFB6-2A4B-4AFC-8572-892DCCC3577F:get-download-url?type=PREVIEW_IMAGE. The response carries url and expiresInSeconds; see the 200 example below.
- Send a plain GET to the returned url directly against S3. Do not send an Authorization header on this request — the presigned URL carries its own credentials and S3 rejects requests that also present a bearer token.
- A 404 from the presigned URL means no thumbnail has been uploaded for the collection. That is not an error from this endpoint; it is the documented empty state.
- The URL expires after expiresInSeconds. Do not cache it beyond that — request a fresh one instead.
Resource Information
| Method and URI | POST https://api.aps.autodesk.com/content-catalog/v2/hubs/{hubId}/collections/{collectionId}:get-download-url |
| Authentication Context | user context required |
| Required OAuth Scopes | data:write |
| Data Format | JSON |
Request
Headers
| Authorization* string | Must be Bearer <token>, where <token> is a three-legged access token obtained via an
Authorization Code flow
or a Secure Service Account flow.
The Secure Service Account (SSA) flow is designed for headless server-to-server operations. While it functions like a two-legged flow (no user interaction), it is classified as three-legged because it preserves user context. |
| Region string | Region identifier for API routing. Defaults to US if not provided. |
* Required
Request
URI Parameters
| hubId string: UUID | Hub ID that owns the collection |
| collectionId string: UUID | Collection ID to download thumbnail for |
Request
Query String Parameters
| type* enum:string | The type of asset URL to generate Will always be: PREVIEW_IMAGE |
* Required
Response
HTTP Status Code Summary
| 200 OK | Presigned download URL generated successfully |
| 403 Forbidden | The request was successfully validated, but lacking the required permissions. Verify your credentials and permissions before you send the request again. |
| 404 Not Found | The requested resource was not found. Review the request and try again. |
Response
Body Structure (200)
| url string | Presigned S3 URL for downloading the thumbnail |
| expiresInSeconds int | Number of seconds until the presigned URL expires |
Example
Presigned download URL generated successfully
Request
curl -v 'https://developer.api.autodesk.com/content-catalog/v2/hubs/A122B37C-D8CD-497C-9DF3-24971A4C17BB/collections/C652DFB6-2A4B-4AFC-8572-892DCCC3577F:get-download-url?type=PREVIEW_IMAGE' \
-X 'POST' \
-H 'Authorization: '
Response
{
"url": "https://bucket.s3.region.amazonaws.com/public/.../Libraries/....png?X-Amz-Algorithm=...",
"expiresInSeconds": 3600
}