v2/hubs/{hubId}/content-upload-requests:create
Batch-create one or more Content Upload Requests in a hub and return presigned URLs for content ingestion (CONTENT, TYPE_CATALOG, PREVIEW_IMAGE).
All requests are created in PENDING status regardless of caller role; the status advances later through the dedicated approval action endpoints.
Required fields. Every item must supply proposedRevision.category; an item that omits it, or sends it blank, is reported as a per-item error rather than failing the whole batch.
Authorization. Non-admin callers must specify at least one collectionId they have upload permission for.
Limits. The request body is an array with a maximum of 20 elements.
Status codes. Returns 201 when every request succeeds, 207 when some succeed and some fail, and a 4xx/5xx error when the request cannot be processed.
Resource Information
| Method and URI | POST https://api.aps.autodesk.com/content-catalog/v2/hubs/{hubId}/content-upload-requests:create |
| 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
| 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 |
| product string | Authoring product. When supplied it must be a canonical product name: “Revit”, “None”, “AutoCAD”, “Rhino”, “Grasshopper”, “Dynamo”, “FormIt”, “MicroStation”, “SketchUp”, “Microsoft Excel”, “Microsoft Word”, “Miscellaneous”, “Microsoft PowerPoint”, “3DSMax”, “ArchiCAD”, “Maya”, “Solidworks”, “Adobe Photoshop”, “Adobe Illustrator”, “Navisworks”, “Blender”, “Autodesk Inventor”, “Adobe InDesign”, “Video”, “Microstation V8i”, “Microstation CONNECT”, “Civil 3D”. |
| collectionIds array: string | Unique IDs of collections this content upload request belongs to. |
| tagIds array: string | Unique IDs of tags associated with this content upload request. |
| 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) |
Response
HTTP Status Code Summary
| 201 Created | All content upload requests were created successfully. |
| 207 | Multi-status - some content upload requests succeeded and some failed. |
| 400 Bad Request | The request was malformed or every item 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 item 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 request was successfully validated, but lacking the required permissions. 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. |
| 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 (201)
| results array: object | Successfully created content upload requests with presigned URLs. Empty when every item failed. |
| contentUploadRequest object | A content upload request staging record. Every property is always present on a response; optional values are returned as null rather than omitted. A record exists only while the request is PENDING, DECLINED or CANCELED: approval deletes it, so an approvalStatus of APPROVED appears only in the approve endpoint’s own response and never on a get or list. |
| 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). |
| 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 item 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 created content upload requests with presigned URLs. Empty when every item failed. |
| contentUploadRequest object | A content upload request staging record. Every property is always present on a response; optional values are returned as null rather than omitted. A record exists only while the request is PENDING, DECLINED or CANCELED: approval deletes it, so an approvalStatus of APPROVED appears only in the approve endpoint’s own response and never on a get or list. |
| 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). |
| 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 item 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 - some content upload requests succeeded and some failed.
Request
curl -v 'https://developer.api.autodesk.com/content-catalog/v2/hubs/757FF58F-AE23-42D8-B303-BD7B53FA2B98/content-upload-requests:create' \
-X 'POST' \
-H 'Authorization: ' \
-H 'Content-Type: application/json' \
-d '[
{
"fileName": "Wall Speaker.rfa",
"contentType": "RFA",
"product": "Revit",
"collectionIds": [
"1F1A9FB6-07EF-421E-8DE1-F1006CAEB1D2"
],
"tagIds": [
"B5DB822F-2D18-4CF9-B170-07563768D722"
],
"proposedRevision": {
"category": "Furniture",
"notes": "Updated design",
"productVersion": "2025",
"metadata": {
"hasTypeCatalog": true,
"materialClass": "Concrete",
"measurementSystem": "IMPERIAL",
"fillPatternType": "Solid",
"parameterGroups": [
{
"name": "",
"parameters": [
{
"name": "",
"value": "",
"displayValue": ""
}
]
}
]
}
}
}
]'
Response
{
"results": [
{
"contentUploadRequest": {
"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"
},
"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"
}
]
}