Skip to main content
PATCH
cURL
Send name, model, or both — an empty body is rejected. Renaming a category rewrites the category label on all of its dispositions in the same transaction. Changing model switches the LLM used for the category’s extraction pass on subsequent calls.

Authorizations

Authorization
string
header
required

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

Path Parameters

category_id
string<uuid>
required

The category to update.

Body

application/json

Fields to update on the category.

Request body for updating an extraction category. Only included fields are changed, but at least one of name or model must be present — an empty body is rejected. Renaming a category rewrites the category label on all of its dispositions in the same transaction.

name
string
required

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

Example:

"Conversion Signals"

model
enum<string>

New 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 updated

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"