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:
- Go to the APS Portal and sign in with your Autodesk ID.
- Create a new application or use an existing one.
- Enable the Content Catalog API for your application.
- 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.
- Acquire a 3-legged OAuth token.
- Required scopes:
data:readand/ordata:write
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:
- Activate the Library: Hub administrators can activate the Content Catalog Library through the Forma web application.
- Verify Forma project access: You must have ‘Project Member’ access to at least one Forma project.
- 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:
- Call
GET /project/v1/hubsto list hubs accessible to the authenticated user. See List Hubs in the Data Management API reference. - Identify the hub you want to work with by its name.
- Note the hub
idfrom 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"
}
}
]
}
Common Headers
All Content Catalog API requests require the following headers:
| Header | Required | Description |
|---|---|---|
| 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:writescope) - Create and manage tags, saved searches, saved search groups, collections, and content (requires
data:writescope) - 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.