API Reference

The Context Source Object

Properties
context_source_id
string
Unique ID of the context source.
workspace_id
string
The ID of the workspace that contains the context source.
project_id
string, nullable
The ID of the project that contains the context source.
created
datetime
UTC timestamp for when the context source was created.
updated
datetime
UTC timestamp for when the context source was updated.
name
string
Name of the context source.
type
string
The type of context source, either file or text.
description
string, nullable
Description of the context source.
versions
List of versions for the context source; can be empty. If the context source has versions, by default the list will include only the context source's primary version. If the versions expand is used, the list will include all versions for the context source.
The File Context Source Object - Fully Expanded
{
   "context_source_id": "cts_2qRzu8geIvfudcJTwP0pur4TbMJ",
   "workspace_id": "wrk_2nKxr84BuEQIpUl3evP3XYyTxdo",
   "project_id": "prj_32Tk7u9OX9HN7AUXm3EjJKRJ5yD",
   "created": "2024-12-19T20:33:15.7387Z",
   "updated": "2024-12-19T20:33:15.971617Z",
   "name": "File context source name",
   "type": "file",
   "description": "File context source description",
   "versions": [
      {
         "version_id": "ctv_2qRzu8qzlNOMhTrini2EKCDh5r6",
         "context_source_id": "ctx_2qRzu8geIvfudcJTwP0pur4TbMJ",
         "created": "2024-12-19T20:33:16.076891Z",
         "updated": "2024-12-19T20:39:13.026997Z",
         "is_primary": true,
         "is_locked": false,
         "locked_by": null,
         "name": null,
         "type": "file",
         "file_name": "file.md",
         "file_size_in_bytes": 17824,
         "file_download_url": "https://download-url",
         "knowledge": [
            {
               "knowledge_id": "ctk_3M7OUPdw2IMvrQVdd8zrFqetV6n",
               "version_id": "ctv_3LyAVJDbCB4xSTPrxjRTY3r92R4",
               "context_source_id": "cts_3LyAU93I7zo1MLRqXY7owMWOufG",
               "created": "2026-11-14T23:15:56.4262343Z",
               "use_case": "Use case for the extracted knowledge.",
               "title": "Knowledge title",
               "content": "This is extracted knowledge."
            }
         ]
      }
   ]
}

The Text Context Source Object - Fully Expanded
{
   "context_source_id": "cts_2qRzu8geIvfudcJTwP0pur4TbMJ",
   "workspace_id": "wrk_2nKxr84BuEQIpUl3evP3XYyTxdo",
   "project_id": "prj_32Tk7u9OX9HN7AUXm3EjJKRJ5yD",
   "created": "2024-12-19T20:33:15.7387Z",
   "updated": "2024-12-19T20:33:15.971617Z",
   "name": "Text context source name",
   "type": "text",
   "description": "Text context source description",
   "versions": [
      {
         "version_id": "ctv_2qRzu8qzlNOMhTrini2EKCDh5r6",
         "context_source_id": "ctx_2qRzu8geIvfudcJTwP0pur4TbMJ",
         "created": "2024-12-19T20:33:16.076891Z",
         "updated": "2024-12-19T20:39:13.026997Z",
         "is_primary": true,
         "is_locked": false,
         "locked_by": null,
         "name": null,
         "type": "text",
         "content": "This is a reusable piece of text.",
         "knowledge": [
            {
               "knowledge_id": "ctk_3M7OUPdw2IMvrQVdd8zrFqetV6n",
               "version_id": "ctv_3LyAVJDbCB4xSTPrxjRTY3r92R4",
               "context_source_id": "cts_3LyAU93I7zo1MLRqXY7owMWOufG",
               "created": "2026-11-14T23:15:56.4262343Z",
               "use_case": "Use case for the extracted knowledge.",
               "title": "Knowledge title",
               "content": "This is extracted knowledge."
            }
         ]
      }
   ]
}