API Reference

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Agent Configs

Create Agent Config

POST/v5/agent_configs

List Agent Configs

GET/v5/agent_configs

List MCP Tool Names

GET/v5/agent_configs/mcp_tools

Get Agent Config

GET/v5/agent_configs/{agent_config_id}

Update Agent Config

PATCH/v5/agent_configs/{agent_config_id}

Delete Agent Config (hard delete)

DELETE/v5/agent_configs/{agent_config_id}

ModelsExpand Collapse

RepoSpec object { url, depth, path }

A single repo the agent should clone into its workspace.

Mirrors the per-entry shape the golden agent’s _validate_repos accepts: url is required, the rest are optional passthrough hints. Sent verbatim as task.params.repos so provisioning clones these instead of the deployment-global default.

url: string

maxLength2048

minLength1

depth: optional number

minimum1

path: optional string

maxLength1024

AgentConfigCreateResponse object { id, allowed_tools, created_at, 9 more }

id: string

allowed_tools: array of string

created_at: string

formatdate-time

harness: string

model: string

name: string

system_prompt: string

updated_at: string

formatdate-time

description: optional string

object: optional "agent_config"

persistent_workspace: optional boolean

repos: optional array of RepoSpec { url, depth, path }

url: string

maxLength2048

minLength1

depth: optional number

minimum1

path: optional string

maxLength1024

AgentConfigListResponse object { id, allowed_tools, created_at, 9 more }

id: string

allowed_tools: array of string

created_at: string

formatdate-time

harness: string

model: string

name: string

system_prompt: string

updated_at: string

formatdate-time

description: optional string

object: optional "agent_config"

persistent_workspace: optional boolean

repos: optional array of RepoSpec { url, depth, path }

url: string

maxLength2048

minLength1

depth: optional number

minimum1

path: optional string

maxLength1024

AgentConfigListMcpToolsResponse = array of "Slack" or "Linear" or "GitHub" or 21 more

One of the following:

"Slack"

"Linear"

"GitHub"

"Confluence"

"Notion"

"Datadog"

"PagerDuty"

"Salesforce"

"Figma"

"Granola"

"Jira"

"Gmail"

"GoogleCalendar"

"GoogleDrive"

"GoogleDocs"

"GoogleSheets"

"GoogleSlides"

"Snowflake"

"Redash"

"Tableau"

"Metabase"

"Gong"

"ZoomInfo"

"Clay"

AgentConfigRetrieveResponse object { id, allowed_tools, created_at, 9 more }

id: string

allowed_tools: array of string

created_at: string

formatdate-time

harness: string

model: string

name: string

system_prompt: string

updated_at: string

formatdate-time

description: optional string

object: optional "agent_config"

persistent_workspace: optional boolean

repos: optional array of RepoSpec { url, depth, path }

url: string

maxLength2048

minLength1

depth: optional number

minimum1

path: optional string

maxLength1024

AgentConfigUpdateResponse object { id, allowed_tools, created_at, 9 more }

id: string

allowed_tools: array of string

created_at: string

formatdate-time

harness: string

model: string

name: string

system_prompt: string

updated_at: string

formatdate-time

description: optional string

object: optional "agent_config"

persistent_workspace: optional boolean

repos: optional array of RepoSpec { url, depth, path }

url: string

maxLength2048

minLength1

depth: optional number

minimum1

path: optional string

maxLength1024

AgentConfigDeleteResponse object { id, deleted, object }

id: string

deleted: boolean

object: optional "agent_config"