Delete a collection or its thumbnail
DELETE
v2/hubs/{hubId}/collections/{collectionId}
Deletes a collection or its thumbnail image.
- Without the type query parameter: deletes the collection itself.
- With type=PREVIEW_IMAGE: deletes the collection’s thumbnail image from S3. Only the Content Catalog admin group can delete thumbnails, and the call is idempotent — 204 is returned even if no thumbnail exists.
Permissions: deleting a collection requires edit access to it (the Content Catalog admin group always has it). Deleting a thumbnail is restricted to the Content Catalog admin group.
Examples:
- Delete the collection — DELETE /v2/hubs/A122B37C-D8CD-497C-9DF3-24971A4C17BB/collections/C652DFB6-2A4B-4AFC-8572-892DCCC3577F returns 204 No Content.
- Delete only the thumbnail, leaving the collection itself untouched — DELETE /v2/hubs/A122B37C-D8CD-497C-9DF3-24971A4C17BB/collections/C652DFB6-2A4B-4AFC-8572-892DCCC3577F?type=PREVIEW_IMAGE returns 204 No Content, even when the collection has no thumbnail.
- Collection is not empty — the same DELETE returns 409 Conflict. A collection that still holds non-deleted content cannot be deleted; this is the most common failure. Delete or move the content to another collection first, then retry.
Resource Information
| Method and URI | DELETE https://api.aps.autodesk.com/content-catalog/v2/hubs/{hubId}/collections/{collectionId} |
| 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. |
* Required
Request
URI Parameters
| hubId string: UUID | Hub ID that owns the collection |
| collectionId string: UUID | Collection ID to delete (or whose thumbnail to delete) |
Request
Query String Parameters
| type enum:string | The type of asset to delete. When specified, only the asset of this type
is deleted rather than the collection itself.
Will always be: PREVIEW_IMAGE |
Response
HTTP Status Code Summary
| 204 No Content | Collection or thumbnail deleted successfully |
| 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. |
| 409 Conflict | Collection cannot be deleted because it still contains content |
| 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 (204)
Response for 204 has no body.
Example
Collection or thumbnail deleted successfully
Request
curl -v 'https://developer.api.autodesk.com/content-catalog/v2/hubs/A122B37C-D8CD-497C-9DF3-24971A4C17BB/collections/C652DFB6-2A4B-4AFC-8572-892DCCC3577F?type=PREVIEW_IMAGE' \
-X 'DELETE' \
-H 'Authorization: '
Response
204 No Content