v2/hubs/{hubId}/content-upload-requests/{contentUploadRequestId}
Returns a single content upload request by id.
Authorization. The caller must be a hub admin, administer at least one of the request’s collections, or be the request’s creator; a request they may not read is reported as 404, exactly as a non-existent one is, so the response never confirms it exists.
Approved requests. An approved request cannot be retrieved either — approval deletes it — so this endpoint returns 404 for it too, and never returns a request whose approvalStatus is APPROVED. Use the Content endpoints to look up the content an approved request produced.
Resource Information
| Method and URI | GET https://api.aps.autodesk.com/content-catalog/v2/hubs/{hubId}/content-upload-requests/{contentUploadRequestId} |
| Authentication Context | user context required |
| Required OAuth Scopes | data:read |
| 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. |
Request
URI Parameters
| hubId string | Unique identifier for an individual hub (UUID format, uppercase). |
| contentUploadRequestId string | Unique identifier for the content upload request (UUID format, uppercase). |
Response
HTTP Status Code Summary
| 200 OK | The content upload request. |
| 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 or content upload request was not found — including a request that was approved, since approval deletes it, and one the caller may not read, which is deliberately indistinguishable from a request that does not exist. Review the request and try again. |
| 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)
| id string | Unique identifier for the content upload request (UUID format, uppercase). |
| hubId string | Hub identifier (UUID format, uppercase). |
| fileName string | Name of the file including extension. |
| contentType enum:string | Content file type. Values are the canonical wire names from FileType.getName()
(e.g. RFA, 3DM, MP4). Used on both request and response.
Possible values: ANY, RFA, DWG, SKP, PDF, ZIP, DXF, RTF, RVT, SYSTEM_TYPE, VIEW, SCHEDULE, DETAIL_GROUP, MODEL_GROUP, RTE, 3DM, 3DM_BAK, RWS, AXM, STL, OBJ, SAT, TIF, TXT, DGN, LAYOUT, GH_3D, DYF, DYN, XLS, XLSM, XLSB, XLSX, CSV, DOCX, DOC, PPTX, PPT, 3DS, MAX, MA, MB, PSD, AI, EPS, JPG, JPEG, BMP, PNG, GIF, TIFF, NWD, NWC, NWF, DWT, PCP, CTB, STB, PAT, SHX, PC3, SCR_, ADSK, ADSK_LIB, FBX, LSP, VLX, RFT, GH, GHX, IPT, IAM, BLEND, SLD_PRT, BCF_ZIP, DAE, IFC, INDD, TTF, OTF, LSB, PY, PYC, CSS, VIS_MAT, MP4, AVI, WMV, RFA_MAT, CEL, DGN_LIB, RVT_SHEET, SKM, STYLE, JSON, FILL_PATTERN, IES, RMTL, XLTX, DWS, RAR, MP3, WAV, AAC, MOV, IND, PKT |
| approvalStatus enum:string | Approval status of a content item or upload request.
Possible values: PENDING, DECLINED, APPROVED, CANCELED |
| product string | Authoring product (design program), or null when not supplied. When set it is a canonical product name — “Revit” (with no year suffix) or the name of another supported design program (e.g. “AutoCAD”, “Civil 3D”). See the create request for the full list. |
| collectionIds array: string | Associated collection IDs. Null when none are associated. |
| tagIds array: string | Associated tag IDs. Null when none are associated. |
| proposedRevision object | Proposed revision for the upload. Similar to ContentModel.currentRevision but without a revision number, which is assigned upon approval. |
| category string | Content category. Required when creating an upload request - an item without one is rejected as a per-item error. |
| notes string | Revision notes. Null when none were supplied. |
| productVersion string | Authoring product version. Null when not supplied. |
| metadata object | Revision-type-specific metadata. The fields present depend on the content type; the properties listed here represent the current supported set. |
| hasTypeCatalog boolean | Whether the source file has an associated type catalog. Caller-supplied and informational only — not verified against the uploaded type catalog source file. Null when not supplied. |
| materialClass string | Material class. Null when not supplied. |
| measurementSystem enum:string | Measurement system used by a content item or revision.
Possible values: IMPERIAL_DECIMAL, IMPERIAL, METRIC |
| fillPatternType string | Fill pattern type. Null when not supplied. |
| parameterGroups array: object | Extended parameters; for example, Revit parameters. Null when none are supplied. |
| name string | Display or logical name of the parameter group |
| parameters array: object | Parameters in this group |
| name string | Name of the parameter |
| value string | Raw value of the parameter (typically numeric or internal representation) |
| displayValue string | Display value of the parameter (formatted for UI display) |
| createdAt datetime: ISO 8601 | Creation timestamp. |
| updatedAt datetime: ISO 8601 | Last update timestamp. |
| uploadedAt datetime: ISO 8601 | Upload timestamp assigned by the server when the request was created. Every request created by the same call shares one value, so a multi-file upload is identifiable as a single batch. It cannot be supplied or changed by a caller. Always present on a response; null when not set. |
| createdBy string | Creator identifier (Autodesk ID). |
| updatedBy string | Last modifier identifier (Autodesk ID). |
Example
The content upload request.
Request
curl -v 'https://developer.api.autodesk.com/content-catalog/v2/hubs/757FF58F-AE23-42D8-B303-BD7B53FA2B98/content-upload-requests/550E8400-E29B-41D4-A716-446655440001' \
-H 'Authorization: '
Response
{
"id": "550E8400-E29B-41D4-A716-446655440001",
"hubId": "3BB2AB76-42A9-4E02-8D66-B8779A0DD0CF",
"fileName": "Wall Speaker.rfa",
"contentType": "RFA",
"approvalStatus": "PENDING",
"product": "Revit",
"collectionIds": [
"42E7EF17-C508-4954-9B40-025CC1369ED5"
],
"tagIds": [
"972F6B4B-C45E-4E89-B16F-7DF8DB2EBF4D"
],
"proposedRevision": {
"category": "Furniture",
"notes": "Updated design",
"productVersion": "2025",
"metadata": {
"hasTypeCatalog": true,
"materialClass": "Concrete",
"measurementSystem": "IMPERIAL",
"fillPatternType": "Solid",
"parameterGroups": [
{
"name": "",
"parameters": [
{
"name": "",
"value": "",
"displayValue": ""
}
]
}
]
}
},
"createdAt": "2025-06-11T17:43:45.881Z",
"updatedAt": "2025-06-11T17:43:45.881Z",
"uploadedAt": "2025-06-11T17:43:45.881Z",
"createdBy": "QPT2UZV6LE7H9XN6",
"updatedBy": "QPT2UZV6LE7H9XN6"
}