Request

Response

    Update content
    PATCH

    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
    * Required

    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)
    * Required

    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)

    Expand all
    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"
              ]
            }
          ]'
    
    Show More

    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"
    }
    
    Show More