---
title: "Asset Hub"
description: "Discover hubs and assets, manage hub access, create and organize assets, and maintain the attribute taxonomy in Asset Hub."
contentType: "overview"
url: "https://developer.mindtickle.com/docs/asset-hub/"
---

The Asset Hub APIs let you discover and retrieve content from your organization's Asset Hubs, and automate the lifecycle of that content. Use them to list active hubs and published assets, to read metadata, media files, and transcripts, and to create hubs, manage collaborators and user access, process assets in bulk, and maintain your attribute taxonomy.

## Key capabilities

- **Hub and asset discovery:** Retrieve paginated lists of all active hubs and the published assets they contain.
- **Asset details:** Access metadata and attributes for specific assets so they display accurately in third-party applications.
- **Media and transcript retrieval:** Fetch signed URLs for raw content files, along with thumbnails and text transcripts.
- **Hub management:** Create restricted or public hubs to scale your content organization.
- **Access control:** Bulk update hub collaborator permissions and control individual user access to restricted hubs.
- **Asset operations:** Create assets asynchronously, delete them permanently, move or mirror them across hubs, and archive them in bulk.
- **Taxonomy governance:** Create attribute categories, create attributes within them, and delete attributes when they are no longer needed.

## Prerequisites and shared context

To call these endpoints, you need to be familiar with the following platform standards:

- **Authentication:** How to generate and use your Bearer token.
- **Base URLs:** The correct regional endpoint for your account.
- **Rate limits:** Platform quotas and retry logic.
- **Conventions:** Standard JSON data formats and HTTP status codes.

For more information, see [Authentication and setup](/docs/getting-started/authentication-and-setup/).

:::note
The Asset Hub content endpoints (list active hubs, list published assets in a hub, get asset details, and get asset media and transcript) use the API3 base URL instead of the standard API base URL.
:::

## Pagination

The content discovery endpoints, List active hubs and List published assets in a hub, support pagination with `limit` and `skip`. Async status endpoints document their own pagination defaults.

- `limit`: Maximum number of results per page. Default is 100. Maximum allowed is 100.
- `skip`: Number of results to skip.

Example:

```json
{
  "limit": 100,
  "skip": 200
}
```

:::note
If `limit` is set higher than 100, the server returns an error. Use pagination to fetch additional results.
:::

## Filtering

You can filter assets and hubs with these fields:

- `hub_ids`: array of strings.
- `asset_ids`: array of strings.
- `sharing_type`: `EXTERNAL` or `INTERNAL`.

Invalid IDs are silently ignored, and the response omits non-matching results.

## Sorting

Use `order_by` to sort list responses. Both `field` and `order` are required.

- `field`: `title`, `created_at`, `updated_at`, and the other columns each list endpoint supports.
- `order`: `ASC` or `DESC`.

Example:

```json
{
  "order_by": {
    "field": "created_at",
    "order": "ASC"
  }
}
```

## In this category

- [Hubs](/docs/asset-hub/hubs/): List active hubs, create hubs, and manage collaborators and user access.
  - [List active hubs](/docs/asset-hub/hubs/list-active-hubs/): Returns a paginated list of all active hubs.
  - [Create a hub](/docs/asset-hub/hubs/create-a-hub/): Creates a hub with a name, an access type, and an optional description.
  - [Manage hub collaborators](/docs/asset-hub/hubs/manage-hub-collaborators/): Adds or removes hub-level permissions for multiple collaborators in one request.
  - [Manage user access for restricted hubs](/docs/asset-hub/hubs/manage-user-access-for-restricted-hubs/): Shares or revokes access to a restricted hub for individual users.
- [Assets](/docs/asset-hub/assets/): Read published assets and their media, and create, archive, map, and delete assets.
  - [List published assets in a hub](/docs/asset-hub/assets/list-published-assets-in-a-hub/): Returns a paginated list of published assets in a hub.
  - [Get asset details](/docs/asset-hub/assets/get-asset-details/): Returns the metadata and attributes of an asset.
  - [Get asset media and transcript](/docs/asset-hub/assets/get-asset-media-and-transcript/): Returns the media type, signed raw content URL, transcript, and thumbnail of an asset.
  - [Create assets](/docs/asset-hub/assets/create-assets/): Creates assets from Content Center files asynchronously.
  - [Archive assets](/docs/asset-hub/assets/archive-assets/): Archives multiple assets in one request.
  - [Move or mirror assets](/docs/asset-hub/assets/move-or-mirror-assets/): Moves or mirrors assets across hubs asynchronously.
  - [Delete assets](/docs/asset-hub/assets/delete-assets/): Permanently deletes multiple assets by ID.
- [Asset taxonomy](/docs/asset-hub/asset-taxonomy/): Create attribute categories and attributes, and delete attributes that are no longer needed.
  - [Create attribute categories](/docs/asset-hub/asset-taxonomy/create-attribute-categories/): Creates attribute categories such as Region or Product line.
  - [Create attributes](/docs/asset-hub/asset-taxonomy/create-attributes/): Creates attributes under an existing attribute category.
  - [Delete attributes](/docs/asset-hub/asset-taxonomy/delete-attributes/): Deletes one or more attributes by ID.

## Related

- [Getting started](/docs/getting-started/): Base URLs, authentication, rate limits, and status codes.
- [Content Center](/docs/content-center/): The files that assets are created from.