v2/hubs/{hubId}/contents/{contentId}
Partially updates an existing content item in the specified hub using JSON Patch operations (RFC 6902).
Allowed paths. /fileName, /collectionIds, /tagIds. Any other path is rejected with HTTP 400.
Supported operations. Only replace, add, and test are accepted. remove, move, and copy are rejected with HTTP 400 (Operation ‘remove’ is not allowed. Allowed operations: [add, test, replace]).
- replace — any allowed path. Replaces the whole value; on /tagIds and /collectionIds the supplied array replaces the existing one.
- add — any allowed path, plus the append pointers /tagIds/- and /collectionIds/- (see below). On a plain path add sets the whole value, so it behaves like replace.
- test — any allowed path. Asserts the current value as a precondition; modifies nothing (see below).
Appending (`add`). /tagIds and /collectionIds support appending a single value without replacing the whole array, using the RFC 6902 append pointer: add with path /tagIds/- or /collectionIds/-. Appending a value that is already present is a no-op. Indexed pointers such as /tagIds/0 are not supported.
Value arity. The pointer, not the operation, decides how many values are sent: add or replace on /tagIds sets the whole array and requires a JSON array value, while add on /tagIds/- appends exactly one value. Sending a single value to /tagIds is rejected with HTTP 400 (Patch path ‘/tagIds’ with an ‘add’ operation replaces the whole array and expects a JSON array value; received JSON type ‘string’. To append a single value, use path ‘/tagIds/-‘.).
Testing (`test`). test changes nothing. It asserts that the value currently stored at path equals value, and rejects the entire patch document with HTTP 400 if it does not — no operation in the document is applied. Use it to guard a change against a concurrent update by sending the test and the modifying operation in the same request.
Matching is exact JSON equality. On an array path the supplied array must hold the same values, in the same order, with the same casing — it is not a “contains” check, and ids are compared exactly as sent (a test value is not case-normalized, unlike a replace value). A document containing only test operations returns HTTP 200 with the field unchanged, but is still recorded as an update to the content item (updatedAt and updatedBy change).
Resource Information
| Method and URI | PATCH https://api.aps.autodesk.com/content-catalog/v2/hubs/{hubId}/contents/{contentId} |
| 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-patch+json |
Request
URI Parameters
| hubId string | Unique identifier for a customer hub (UUID format, uppercase) |
| contentId string | Unique identifier for the content item |
Request
Body Structure
| op* enum:string | The operation to perform. Only add, replace, and test are supported for content.
Possible values: add, replace, test |
| path* string | JSON Pointer to the target field; see the endpoint description for the allowed paths. |
| value object | The value to use for the operation (required for add, replace, test) |
Response
HTTP Status Code Summary
| 200 OK | Content successfully updated |
| 400 Bad Request | The server was unable to process the request. The syntax of the request is malformed, the patch targets a non-allowlisted path, or the request is missing a required header. |
| 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. |
| 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 |
| fileName string | Name of the file |
| product string | Content product name |
| 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 |
| comments string | Comments |
| collectionIds array: string | Associated collection IDs |
| tagIds array: string | Associated tag IDs |
| currentRevision object | Details of a content revision |
| id string | File revision identifier |
| revisionNumber int | Revision number |
| productVersions array: string | List of product versions associated with the revision |
| category string | Content category |
| fileSize int | Size of the revision’s base file, in bytes. Resolved from the earliest base file version, falling back to legacy stored values for revisions that predate per-version size tracking. |
| metadata object | Revision-type-specific metadata fields |
| hasTypeCatalog boolean | Whether or not this content item has an associated type catalog |
| materialClass string | Material class for this revision |
| measurementSystem enum:string | Measurement system used by a content item or revision.
Possible values: IMPERIAL_DECIMAL, IMPERIAL, METRIC |
| fillPatternType string | Fill pattern type |
| preferredPreviewImageNames array: string | Preview images |
| parameterGroups array: object | Parameter groups for this revision |
| 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) |
| notes string | Revision notes |
| createdAt datetime: ISO 8601 | Creation timestamp |
| updatedAt datetime: ISO 8601 | Last update timestamp |
| createdBy string | Creator identifier (Autodesk ID) |
| updatedBy string | autodeskId of the user who last modified the content |
| createdAt datetime: ISO 8601 | Creation timestamp |
| updatedAt datetime: ISO 8601 | Last update timestamp |
| createdBy string | Creator identifier (Autodesk ID) |
| updatedBy string | Last modifier identifier (Autodesk ID) |
Example
Content successfully updated
Request
curl -v 'https://developer.api.autodesk.com/content-catalog/v2/hubs/3BB2AB76-42A9-4E02-8D66-B8779A0DD0CF/contents/550e8400-e29b-41d4-a716-446655440001' \
-X 'PATCH' \
-H 'Authorization: ' \
-H 'Content-Type: application/json-patch+json' \
-d '[
{
"op": "add",
"path": "/tagIds",
"value": [
"tag-001",
"tag-002"
]
}
]'
Response
{
"id": "550e8400-e29b-41d4-a716-446655440001",
"fileName": "sample-family.rfa",
"product": "REVIT",
"contentType": "RFA",
"comments": "Some comments",
"collectionIds": [
"col-001",
"col-002"
],
"tagIds": [
"tag-001",
"tag-002"
],
"currentRevision": {
"id": "2BDC268B-55D7-4792-B846-19A155CCF777",
"revisionNumber": 1,
"productVersions": [
"2025",
"2026"
],
"category": "Furniture",
"fileSize": 245678,
"metadata": {
"hasTypeCatalog": true,
"materialClass": "Wood",
"measurementSystem": "IMPERIAL",
"fillPatternType": "Solid",
"preferredPreviewImageNames": [
"preview-image.png",
"default-large.png"
]
},
"parameterGroups": [
{
"name": "",
"parameters": [
{
"name": "",
"value": "",
"displayValue": ""
}
]
}
],
"notes": "Updated design",
"createdAt": "2025-06-11T17:43:45.881Z",
"updatedAt": "2025-06-11T17:43:45.881Z",
"createdBy": "QPT2UZV6LE7H9XN6",
"updatedBy": "QPT2UZV6LE7H9XN6"
},
"createdAt": "2025-06-11T17:43:45.881Z",
"updatedAt": "2025-06-11T17:43:45.881Z",
"createdBy": "AKB2JV55N3SQ55DT",
"updatedBy": "AKB2JV55N3SQ55DT"
}