Create Extraction Category API
Create an extraction category and attach it to an agent via POST /agent//extraction-categories; the category owns the model used for its LLM pass.
id as category_id.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The agent the category is attached to.
Body
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.
Category name. Must be unique among the agent's attached categories.
"Lead Quality"
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 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.
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"

