Skip to main content
POST
Create a Knowledge Source
Send a title, the sourceType, and the source itself: inline content, a sourceUrl to crawl, or the blobPath returned by Upload a Knowledge Source File. Returns the created source, whose indexStatus tracks indexing progress.

Authorizations

Authorization
string
header
required

JWT Authorization header using the Bearer scheme. Example: "Authorization: Bearer {token}"

Body

The knowledge source to create, including its sourceType and the matching content, blobPath, or sourceUrl.

Request model for creating or updating a knowledge source.

title
string | null

The title of the knowledge source.

description
string | null

The description of what the knowledge source covers.

sourceType
enum<integer>

Where the content comes from: text you send, an uploaded file, or a URL.

Available options:
0,
1,
2,
3,
4,
5
content
string | null

The text of the knowledge source, when the content is sent inline.

blobPath
string | null

The path returned by Upload a Knowledge Source File, when the content comes from a file.

sourceUrl
string | null

The URL to index, when the content comes from a website.

Response

OK

Response model for a knowledge source.

id
integer<int64>

The unique identifier of the knowledge source.

title
string | null

The title of the knowledge source.

description
string | null

The description of what the knowledge source covers.

sourceType
enum<integer>

Where the content comes from: text you send, an uploaded file, or a URL.

Available options:
0,
1,
2,
3,
4,
5
content
string | null

The text of the knowledge source, when the content is sent inline.

blobPath
string | null

The path returned by Upload a Knowledge Source File, when the content comes from a file.

sourceUrl
string | null

The URL to index, when the content comes from a website.

indexStatus
enum<integer>

How far along indexing the source is, such as Pending, Indexed, or Failed.

Available options:
0,
1,
2
lastIndexedUtc
string<date-time> | null

The UTC date and time the source was last indexed.

indexError
string | null

The reason indexing failed, when indexStatus is a failure.

isActive
boolean

Whether the knowledge source is active and used for generation.

createdDateTimeUtc
string<date-time>

The UTC date and time the knowledge source was created.

modifiedDateTimeUtc
string<date-time>

The UTC date and time the knowledge source was last modified.

Last modified on July 28, 2026