List knowledge store items

{
  "data": [
    {
      "asset_type": "video",
      "_id": "ksi_069e9870-3c4d-7abc-9012-3456789abcde",
      "asset_id": "6298d673f1090f1100476d4c",
      "status": "ready",
      "system_metadata": {
        "asset_type": "video",
        "codec_name": "h264",
        "duration": 531.998133,
        "filename": "01.mp4",
        "fps": 29.97,
        "height": 1080,
        "size": 65749715,
        "width": 1920
      },
      "metadata": {},
      "created_at": "2024-01-15T09:30:00Z",
      "updated_at": "2024-01-15T09:30:00Z"
    }
  ],
  "page_info": {
    "limit_per_page": 10,
    "page": 1,
    "total_page": 1,
    "total_results": 2
  }
}

This method returns a list of items in the specified knowledge store.

Authentication

x-api-keystring

Your API key.

Note

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

Path parameters

knowledge_store_idstringRequired

The unique identifier of the knowledge store.

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_byenumOptionalDefaults to created_at

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

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

Default: created_at.

Allowed values:

sort_optionstringOptionalDefaults to desc

The sorting direction. The following options are available:

asc
desc

Default: desc.

statuslist of enumsOptional

Filter by one or more item processing statuses. For the meaning of each value, see the Item statuses section on The knowledge store item object page.

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

status=queued&status=pending

Allowed values:

Response

The knowledge store items have been successfully retrieved.

datalist of objectsOptional

An array containing the knowledge store items.

page_infoobjectOptional

An object that provides information about pagination.

Errors

400

Bad Request Error