Skip to main content
POST
cURL
The category name must be unique among the agent’s attached categories. Add dispositions to the category with the Create Disposition endpoint, passing this category’s id as category_id.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

agent_id
string<uuid>
required

The agent the category is attached to.

Body

application/json

Category to create.

Request body for creating an extraction category. The category is attached to the agent in the URL path; attaching a category gives the agent all of the category's dispositions.

name
string
required

Category name. Must be unique among the agent's attached categories.

Example:

"Lead Quality"

model
enum<string>
required

LLM model for the category's extraction pass.

Available options:
gpt-4.1-mini,
gpt-4.1-nano,
gpt-4o-mini,
gpt-5-mini,
gpt-5-nano,
gpt-5.4-mini,
gpt-5.6-luna,
gemini-3.5-flash,
gemini-3.5-flash-lite
Example:

"gpt-4.1-mini"

Response

Category created and attached to the agent

A named set of dispositions evaluated together in a single LLM pass. The category owns the model used for that pass.

id
string<uuid>

Unique identifier for the category.

Example:

"9b2e8f10-4c7d-4e2a-9f31-6a8d5c1b0e42"

name
string

Category name. Unique among the categories attached to the same agent.

Example:

"Lead Quality"

model
string

LLM model used for the category's extraction pass. Applies to every disposition in the category.

Example:

"gpt-4.1-mini"

agent_id
string<uuid>

The agent this category is attached to.

Example:

"123e4567-e89b-12d3-a456-426614174000"

created_at
string<date-time>

ISO timestamp when the category was created.

Example:

"2026-03-01T10:00:00Z"

updated_at
string<date-time>

ISO timestamp when the category was last updated.

Example:

"2026-03-15T14:30:00Z"