Request

Response

    Batch get content upload request upload URLs
    POST

    v2/hubs/{hubId}/content-upload-requests:get-upload-url

    Returns presigned upload URLs for the artifacts (CONTENT, TYPE_CATALOG, PREVIEW_IMAGE) of one or more content upload requests (batch, maximum 20 ids), for re-uploading staged content.

    Authorization. A URL is only issued for a request the caller may read — hub admin, administrator of at least one of its collections, or its creator — and any other id is reported as a per-item “Content upload request not found” error, indistinguishable from an id that does not exist.

    Approved requests report the same error: approval deletes the request, so its content can no longer be replaced this way.

    Status codes. Items are processed independently: a not-found or invalid id is reported as a per-item error rather than failing the whole batch — 200 (all succeed), 207 (partial), or 400 (all fail).

    Resource Information

    Method and URI
    POST
    https://api.aps.autodesk.com/content-catalog/v2/hubs/{hubId}/content-upload-requests:get-upload-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.
    Content-Type*
    string
    Must be application/json
    * Required

    Request

    URI Parameters

    hubId
    string
    Unique identifier for an individual hub (UUID format, uppercase).

    Request

    Body Structure

    ids*
    array: string
    Ids of the content upload requests to act on (max 20).
    * Required

    Response

    HTTP Status Code Summary

    200
    OK
    Upload URLs were generated for every id.
    207
    Multi-status - upload URLs were generated for some ids and others failed.
    400
    Bad Request
    The request was malformed or every id failed. Request-level failures (malformed body, or a batch size exceeding the maximum of 20 elements) return the standard error body; when the request is well-formed but every id fails, the batch response body is returned with an empty results list and a populated errors list.
    401
    Unauthorized
    The supplied authorization header was not valid or the supplied token scope was not acceptable. Verify authentication and try again.
    403
    Forbidden
    The caller does not have access to this hub. Verify your credentials and permissions before you send the request again.
    404
    Not Found
    The hub was not found. Review the request and try again.
    415
    Unsupported Media Type - the Content-Type header is not application/json.
    500
    Internal Server Error
    An unexpected error occurred on the server, preventing it from completing your request. Please try again later. If the issue persists, contact the support team for assistance.

    Response

    Body Structure (200)

    Expand all
    results
    array: object
    Successfully resolved presigned URLs. Empty when every id failed.
    contentUploadRequestId
    string
    The id of the content upload request the URLs belong to (UUID format, uppercase).
    presignedUrls
    object
    Presigned upload URLs for the upload request artifacts, keyed by artifact type.
    CONTENT
    string
    Presigned upload URL for the primary content file. The PUT request must include the header content-type: application/octet-stream, matching the content-type the URL was signed with.
    TYPE_CATALOG
    string
    Presigned upload URL for the type catalog source file. The PUT request must include the header content-type: application/octet-stream, matching the content-type the URL was signed with.
    PREVIEW_IMAGE
    string
    Presigned upload URL for the preview image. The PUT request must include the header content-type: image/png, matching the content-type the URL was signed with.
    errors
    array: object
    Per-item failures. Empty when every id succeeded.
    index
    int
    Zero-based position of the failed request in the original request array.
    error
    string
    Error message describing why the request failed.
    contentUploadRequestId
    string
    The id of the request that failed, or null when none was assigned before failure.

    Response

    Body Structure (207)

    Expand all
    results
    array: object
    Successfully resolved presigned URLs. Empty when every id failed.
    contentUploadRequestId
    string
    The id of the content upload request the URLs belong to (UUID format, uppercase).
    presignedUrls
    object
    Presigned upload URLs for the upload request artifacts, keyed by artifact type.
    CONTENT
    string
    Presigned upload URL for the primary content file. The PUT request must include the header content-type: application/octet-stream, matching the content-type the URL was signed with.
    TYPE_CATALOG
    string
    Presigned upload URL for the type catalog source file. The PUT request must include the header content-type: application/octet-stream, matching the content-type the URL was signed with.
    PREVIEW_IMAGE
    string
    Presigned upload URL for the preview image. The PUT request must include the header content-type: image/png, matching the content-type the URL was signed with.
    errors
    array: object
    Per-item failures. Empty when every id succeeded.
    index
    int
    Zero-based position of the failed request in the original request array.
    error
    string
    Error message describing why the request failed.
    contentUploadRequestId
    string
    The id of the request that failed, or null when none was assigned before failure.

    Example

    Multi-status - upload URLs were generated for some ids and others failed.

    Request

    curl -v 'https://developer.api.autodesk.com/content-catalog/v2/hubs/757FF58F-AE23-42D8-B303-BD7B53FA2B98/content-upload-requests:get-upload-url' \
      -X 'POST' \
      -H 'Authorization: ' \
      -H 'Content-Type: application/json' \
      -d '{
            "ids": [
              "550E8400-E29B-41D4-A716-446655440001",
              "219FA6F7-3A6E-45D0-B0AE-A34B6B1114C0"
            ]
          }'
    
    Show More

    Response

    {
      "results": [
        {
          "contentUploadRequestId": "550E8400-E29B-41D4-A716-446655440001",
          "presignedUrls": {
            "CONTENT": "https://example.s3.amazonaws.com/public/HUB/ContentUploadModel/ID/1/0/file?...",
            "TYPE_CATALOG": "https://example.s3.amazonaws.com/public/HUB/ContentUploadModel/ID/1/0/typeCatalogSource?...",
            "PREVIEW_IMAGE": "https://example.s3.amazonaws.com/public/HUB/ContentUploadModel/ID/1/images/default-large.png?..."
          }
        }
      ],
      "errors": [
        {
          "index": 3,
          "error": "User does not have upload permission to one or more specified collections",
          "contentUploadRequestId": "550E8400-E29B-41D4-A716-446655440001"
        }
      ]
    }
    
    Show More