Agent Configs

Endpoints for managing agent configurations — AI behavior instructions and Slack trigger settings for an agent.

Attributes

agent agent
Response

The agent this configuration belongs to.
agent_id integer
Request Parameter `filter`

The ID of the agent this configuration belongs to.
ai_model string
Response Request Nullable

The AI model this agent runs on. When null, the platform default applies.
attachments array of attachment
Response

Files attached to this agent configuration, such as knowledge base documents the agent can reference.
created_at string
Response Parameter `filter` Parameter `sort`

The timestamp when this agent configuration was created.
id integer
Parameter `filter`

The unique identifier of the agent configuration.
instructions string
Response Request

The AI behavior instructions for this agent — describes how it should respond, what tasks it handles, and any operational constraints.
reasoning_effort string
Response Request Nullable Enum

How much reasoning effort the agent spends before responding. When null, the platform default applies.

Enum Values (3 values)

  • low
    Low
  • medium
    Medium
  • high
    High
updated_at string
Response Parameter `sort`

The timestamp when this agent configuration was last updated.

Operations

GET /api/v2/agent_configs
Get agent configs
POST /api/v2/agent_configs
Create an agent config
DELETE /api/v2/agent_configs/{id}
Delete an agent config
GET /api/v2/agent_configs/{id}
Get an agent config
PATCH /api/v2/agent_configs/{id}
Update an agent config