Skip to main content
POST
Add knowledge item

Add Knowledge Item

Add one source fact, answer, or knowledge item to an evaluation agent. Use this when your evaluation source material already exists as structured question-answer data and you want to attach it directly to the agent.

Endpoint

Authentication

Send your platform API key in the x-api-key header.

Path Parameters

Request Body

Success Response

Returns 201 Created with the knowledge item that was added.

Authorizations

x-api-key
string
header
required

Platform API key for authenticated account-level API access

Path Parameters

id
string<uuid>
required

Evaluation agent ID.

Body

application/json

Add a knowledge item or expected answer source for an evaluation agent.

label
string
required

Question, title, or short label for the knowledge item.

Example:

"Refund policy"

description
string
required

Answer or source content used during evaluation.

Example:

"Customers can request a refund within 30 days of purchase."

type
enum<string>
default:knowledge

Public evaluation workflows should use knowledge.

Available options:
knowledge
Example:

"knowledge"

Response

Knowledge item created

Knowledge entry attached to an evaluation agent.

id
integer

Knowledge item identifier.

Example:

12

label
string

Question, title, or short label for the knowledge item.

Example:

"Refund policy"

description
string

Answer or source content used during evaluation.

Example:

"Customers can request a refund within 30 days of purchase."

type
enum<string>

Public evaluation workflows should use knowledge.

Available options:
knowledge
Example:

"knowledge"

node_count
integer | null

Number of graph nodes created from this item, when available.

Example:

3

created_at
string<date-time>

Creation timestamp.

Example:

"2026-06-02T15:08:00Z"

updated_at
string<date-time>

Last update timestamp.

Example:

"2026-06-02T15:08:00Z"