v2/hubs/{hubId}/content-upload-requests:get-download-url
Returns presigned download URLs for the staged artifacts (CONTENT, TYPE_CATALOG, PREVIEW_IMAGE) of one or more content upload requests (batch, maximum 20 ids).
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 and its artifacts now belong to the promoted content, so download that through the Content endpoints instead.
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-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. |
| Content-Type* string | Must be application/json |
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). |
Response
HTTP Status Code Summary
| 200 OK | Download URLs were generated for every id. |
| 207 | Multi-status - download 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)
| 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)
| 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 - download 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-download-url' \
-X 'POST' \
-H 'Authorization: ' \
-H 'Content-Type: application/json' \
-d '{
"ids": [
"550E8400-E29B-41D4-A716-446655440001",
"219FA6F7-3A6E-45D0-B0AE-A34B6B1114C0"
]
}'
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"
}
]
}