The knowledge store item object

A knowledge store item is an asset added to a knowledge store for processing. You can use it in downstream workflows once its status is ready.

The object is composed of the following fields:

• _id: A string representing the unique identifier of the knowledge store item.
• asset_type: A string indicating the type of item. It can take one of the following values:
  • video: A video item.
  • image: An image item.
• asset_id: A string representing the unique identifier of the source asset.
• status: A string indicating the processing status of the item. See the Item statuses section for the meaning of each value.
• system_metadata: An object containing system-generated media metadata for the source asset. The shape of this object depends on the value of the asset_type field. For the full structure, see the system_metadata field on the Retrieve a knowledge store item page.
• metadata: An object containing custom metadata for the knowledge store item. Both keys and values are strings.
• created_at: A string representing the date and time, in the RFC 3339 format, when the item was created.
• updated_at: A string representing the date and time, in the RFC 3339 format, when the item was last updated.

Item statuses

The status field of a knowledge store item has one of the following values:

• queued: The item has been submitted and is waiting to be processed.
• pending: The item has been dispatched and is waiting for available processing capacity.
• processing: The item is being processed.
• ready: The item has been successfully processed.
• failed: The item processing has failed.

Examples

Each example shows a populated knowledge store item.

1
{
2
  "_id": "ksi_069e9870-3c4d-7abc-9012-3456789abcde",
3
  "asset_type": "video",
4
  "asset_id": "6298d673f1090f1100476d4c",
5
  "status": "ready",
6
  "system_metadata": {
7
    "asset_type": "video",
8
    "filename": "01.mp4",
9
    "duration": 531.998133,
10
    "fps": 29.97,
11
    "width": 1920,
12
    "height": 1080,
13
    "codec_name": "h264",
14
    "size": 65749715
15
  },
16
  "metadata": {
17
    "project": "Q1 review"
18
  },
19
  "created_at": "2026-05-12T16:53:59Z",
20
  "updated_at": "2026-05-12T16:55:59Z"
21
}