List indexed assets | TwelveLabs

This method returns a list of the indexed assets in the specified index. By default, the platform returns your indexed assets sorted by creation date, with the newest at the top of the list.

Authentication

x-api-keystring

Your API key.

Note

You can find your API key on the API Key page.

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

Path Parameters

index-idstringRequired

The unique identifier of the index for which the platform will retrieve the indexed assets.

Query Parameters

pageintegerOptionalDefaults to 1

A number that identifies the page to retrieve.

Default: 1.

page_limitintegerOptionalDefaults to 10

The number of items to return on each page.

Default: 10. Max: 50.

sort_bystringOptionalDefaults to created_at

The field to sort on. The following options are available:

updated_at: Sorts by the time, in the RFC 3339 format (“YYYY-MM-DDTHH:mm:ssZ”), when the item was updated.
created_at: Sorts by the time, in the RFC 3339 format (“YYYY-MM-DDTHH:mm:ssZ”), when the item was created.

Default: created_at.

The field to sort on. The following options are available: - `updated_at`: Sorts by the time, in the RFC 3339 format ("YYYY-MM-DDTHH:mm:ssZ"), when the item was updated. - `created_at`: Sorts by the time, in the RFC 3339 format ("YYYY-MM-DDTHH:mm:ssZ"), when the item was created. **Default**: `created_at`.

sort_optionstringOptionalDefaults to desc

The sorting direction. The following options are available:

asc
desc

Default: desc.

The sorting direction. The following options are available: - `asc` - `desc` **Default**: `desc`.

statuslist of enumsOptional

Filter by one or more indexing task statuses. The following options are available:

ready: The indexed asset has been successfully uploaded and indexed.
pending: The indexed asset is pending.
queued: The indexed asset is queued.
indexing: The indexed asset is being indexed.
failed: The indexed asset indexing task failed.

To filter by multiple statuses, specify the status parameter for each value:

status=ready&status=validating

Filter by one or more indexing task statuses. The following options are available: - `ready`: The indexed asset has been successfully uploaded and indexed. - `pending`: The indexed asset is pending. - `queued`: The indexed asset is queued. - `indexing`: The indexed asset is being indexed. - `failed`: The indexed asset indexing task failed. To filter by multiple statuses, specify the `status` parameter for each value: ``` status=ready&status=validating ```

Allowed values:

filenamestringOptional

Filter by filename.

durationdoubleOptional

Filter by duration. Expressed in seconds.

fpsdoubleOptional

Filter by frames per second.

widthdoubleOptional

Filter by width.

heightintegerOptional

Filter by height.

sizedoubleOptional

Filter by size. Expressed in bytes.

created_atstringOptional

Filter indexed assets by the creation date and time of their associated indexing tasks, in the RFC 3339 format (“YYYY-MM-DDTHH:mm:ssZ”). The platform returns the indexed assets whose indexing tasks were created on the specified date at or after the given time.

updated_atstringOptional

This filter applies only to indexed assets updated using the PUT method of the /indexes/{index-id}/indexed-assets/{indexed-asset-id} endpoint. It filters indexed assets by the last update date and time, in the RFC 3339 format (“YYYY-MM-DDTHH:mm:ssZ”). The platform returns the indexed assets that were last updated on the specified date at or after the given time.

This filter applies only to indexed assets updated using the [`PUT`](/v1.3/api-reference/videos/update) method of the `/indexes/{index-id}/indexed-assets/{indexed-asset-id}` endpoint. It filters indexed assets by the last update date and time, in the RFC 3339 format ("YYYY-MM-DDTHH:mm:ssZ"). The platform returns the indexed assets that were last updated on the specified date at or after the given time.

user_metadatamap from strings to strings or doubles or booleansOptional

To enable filtering by custom fields, you must first add user-defined metadata to your video by calling the PUT method of the /indexes/:index-id/indexed-assets/:indexed-asset-id endpoint.

Examples:

To filter on a string: ?category=recentlyAdded
To filter on an integer: ?batchNumber=5
To filter on a float: ?rating=9.3
To filter on a boolean: ?needsReview=true

To enable filtering by custom fields, you must first add user-defined metadata to your video by calling the [`PUT`](/v1.3/api-reference/videos/update) method of the `/indexes/:index-id/indexed-assets/:indexed-asset-id` endpoint. Examples: - To filter on a string: `?category=recentlyAdded` - To filter on an integer: `?batchNumber=5` - To filter on a float: `?rating=9.3` - To filter on a boolean: `?needsReview=true`

Response

The indexed assets in the specified index have successfully been retrieved.

datalist of objects or null

An array that contains up to page_limit indexed assets.

page_infoobject or null

An object that provides information about pagination.

1	curl -G https://api.twelvelabs.io/v1.3/indexes/6298d673f1090f1100476d4c/indexed-assets \
2	-H "x-api-key: <apiKey>" \
3	-d filename=01.mp4 \
4	-d duration=10 \
5	-d fps=25 \
6	-d width=1920 \
7	-d height=1080 \
8	-d size=1048576 \
9	--data-urlencode created_at=2024-08-16T16:53:59Z \
10	--data-urlencode updated_at=2024-08-16T16:53:59Z

1	{
2	"data": [
3	{
4	"_id": "62a17bf847f5678267ec10cc",
5	"created_at": "2022-06-09T04:50:00.879Z",
6	"updated_at": "2022-06-09T04:55:57.256Z",
7	"status": "ready",
8	"system_metadata": {
9	"filename": "01.mp4",
10	"duration": 531.998133,
11	"width": 854,
12	"height": 400
13	}
14	},
15	{
16	"_id": "62a17bce47f5678267ec10c6",
17	"created_at": "2022-06-09T04:49:20.001Z",
18	"updated_at": "2022-06-09T04:54:10.345Z",
19	"status": "ready",
20	"system_metadata": {
21	"filename": "02.mp4",
22	"duration": 741.875,
23	"width": 854,
24	"height": 480
25	}
26	}
27	],
28	"page_info": {
29	"limit_per_page": 10,
30	"page": 1,
31	"total_page": 1,
32	"total_results": 2
33	}
34	}

Authentication

Note

Path Parameters

Query Parameters

Response

Errors

Note