Update Extraction Category API
Rename an extraction category or change its model via PATCH /extraction-categories/; renames propagate to the category labels on all its dispositions.
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
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The category to update.
Body
Fields to update on the category.
- Option 1
- Option 2
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.
New category name. Must be unique among the agent's attached categories.
"Conversion Signals"
New LLM model for the category's extraction pass.
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 "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.
Unique identifier for the category.
"9b2e8f10-4c7d-4e2a-9f31-6a8d5c1b0e42"
Category name. Unique among the categories attached to the same agent.
"Lead Quality"
LLM model used for the category's extraction pass. Applies to every disposition in the category.
"gpt-4.1-mini"
The agent this category is attached to.
"123e4567-e89b-12d3-a456-426614174000"
ISO timestamp when the category was created.
"2026-03-01T10:00:00Z"
ISO timestamp when the category was last updated.
"2026-03-15T14:30:00Z"

