Request

Response

    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:

    1. Confirm the collection exists and the caller has read access — GET /v2/hubs/A122B37C-D8CD-497C-9DF3-24971A4C17BB/collections/C652DFB6-2A4B-4AFC-8572-892DCCC3577F.
    2. 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.
    3. 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.
    4. 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.
    5. 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
    }