List agents
Retrieve all agents for your store.Endpoint
Headers
| Header | Value | Required |
|---|---|---|
Authorization | Bearer tb_your-api-key | Yes |
Response
Response fields
| Field | Type | Description |
|---|---|---|
id | string | Unique agent identifier |
name | string | Agent display name |
type | string | Agent type (e.g., customer_support, product_recommendation) |
description | string | Optional agent description |
config | object | Agent configuration (model, prompt, tools) |
created_at | string | ISO 8601 creation timestamp |
updated_at | string | ISO 8601 last update timestamp |
Create an agent
Create a new agent configuration.Endpoint
Headers
| Header | Value | Required |
|---|---|---|
Authorization | Bearer tb_your-api-key | Yes |
Content-Type | application/json | Yes |
Request body
| Field | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Agent display name |
type | string | Yes | Agent type |
description | string | No | Short description |
config.model_provider | string | Yes | anthropic, openrouter, or bedrock |
config.model_id | string | Yes | Model identifier (e.g., claude-sonnet-4-6) |
config.system_prompt | string | Yes | The system prompt |
config.temperature | number | No | 0.0 to 1.0 (default: 0.7) |
config.max_tokens | number | No | Max response tokens (default: 4096) |
config.mcp_capabilities | array | No | MCP tool connections |
Response
Error responses
| Status | Description |
|---|---|
400 | Invalid request body |
401 | Invalid or missing API key |
403 | Agent limit reached for your plan |
500 | Internal server error |