Sign in

v3

latestOpenAPI 3.1.02026-07-3197486526.1 KB
assets

List assets

This method returns a list of assets in your account.

The platform returns your assets sorted by creation date, with the newest at the top of the list.

get/assets

Query parameters

pageinteger

A number that identifies the page to retrieve.

Default: 1.

page_limitinteger

The number of items to return on each page.

Default: 10. Max: 50.

asset_idsstring[]

Filters the response to include only assets with the specified IDs. Provide one or more asset IDs. When you specify multiple IDs, the platform returns all matching assets.

asset_typesAssetsGetParametersAssetTypesSchemaItems[]

Filters the response to include only assets of the specified types. Provide one or more asset types. When you specify multiple types, the platform returns all matching assets.

filenamestring

Filters the response to include only assets whose filename contains the specified string. The match is case-insensitive and supports partial matching.

Headers

x-api-keystring required

Your API key.

<Note title="Note"> You can find your API key on the <a href="https://playground.twelvelabs.io/dashboard/api-keys" target="_blank">API Keys</a> page. </Note>

Response

The assets have been successfully retrieved.