Request

Response

    Before You Begin

    This page describes the prerequisites for using the Content Catalog API.

    Register an Application

    Before you can make calls to the Content Catalog API, you need to register an application on the Autodesk Platform Services (APS) portal:

    1. Go to the APS Portal and sign in with your Autodesk ID.
    2. Create a new application or use an existing one.
    3. Enable the Content Catalog API for your application.
    4. Note your Client ID and Client Secret for authentication.

    For detailed instructions, see Register an App.

    Before you call Content Catalog endpoints, a hub administrator must register your application’s Client ID in that hub. Follow the Custom Integrations instructions to add your integration to the hub you want to access.

    Authentication

    The Content Catalog API uses 3-legged OAuth (3LO) authentication.

    3-Legged OAuth (3LO)

    Use 3-legged OAuth when your application acts on behalf of a user. This is the required authentication method for Content Catalog API.

    For headless server-to-server integrations that must act as a fixed integration user (without interactive sign-in), you can obtain a 3LO access token through the Secure Service Account API. SSA preserves user context while avoiding a browser-based authorization flow.

    Hub Access

    To use the API, make sure the following conditions are met for the user:

    1. Activate the Library: Hub administrators can activate the Content Catalog Library through the Forma web application.
    2. Verify Forma project access: You must have ‘Project Member’ access to at least one Forma project.
    3. Verify permissions: Content access is controlled through User Groups. Confirm you’re a member of a group with access to your target Collections.

    Find Your Hub ID

    The Content Catalog API uses hub IDs to scope operations. List hubs through the APS Project API (not Content Catalog). To find your hub ID:

    1. Call GET /project/v1/hubs to list hubs accessible to the authenticated user. See List Hubs in the Data Management API reference.
    2. Identify the hub you want to work with by its name.
    3. Note the hub id from the response (UUID format) for use in subsequent Content Catalog API calls.

    Request

    curl -X GET \
      -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
      "https://api.aps.autodesk.com/project/v1/hubs"
    

    Response

    {
      "jsonapi": {
        "version": "1.0"
      },
      "data": [
        {
          "type": "hubs",
          "id": "d6cf8c84-c25e-4534-ae5c-62e08480e751",
          "attributes": {
            "name": "My Organization",
            "region": "US"
          }
        }
      ]
    }
    
    Show More

    Common Headers

    All Content Catalog API requests require the following headers:

    HeaderRequiredDescription
    Authorization Yes Bearer token (3LO)
    Region No Region identifier: US, EMEA, AUS. Defaults to US.

    Next Steps

    Once you have your access token and hub ID, you can:

    • Explore available collections within your hub
    • Browse and retrieve content items
    • Access content revisions and download files
    • Create and manage user groups and group membership (requires data:write scope)
    • Create and manage tags, saved searches, saved search groups, collections, and content (requires data:write scope)
    • Follow the Upload Content with Content Upload Requests tutorial to stage and upload new content

    Refer to the API Reference for detailed endpoint documentation, including write, manage, and content upload operations.