Documentation | Agent Configs › Update Agent Config

Agent Configs

agent_configs

Methods

Create Agent Config -> { id, allowed_tools, created_at, 7 more... }

post/v5/agent_configs

Create Agent Config

List Agent Configs -> CursorPage<{ id, allowed_tools, created_at, 7 more... }>

get/v5/agent_configs

List Agent Configs

List Mcp Tool Names -> Array<"Slack" | "Linear" | "GitHub" | 7 more...>

get/v5/agent_configs/mcp_tools

AllowedTool values that route to MCP servers (vs harness-provided tools). Exposed primarily so the generated SDK includes the McpTool enum type — the frontend asserts its own MCP-tool classifier against this enum to prevent drift.

Get Agent Config -> { id, allowed_tools, created_at, 7 more... }

get/v5/agent_configs/{agent_config_id}

Get Agent Config

Update Agent Config -> { id, allowed_tools, created_at, 7 more... }

patch/v5/agent_configs/{agent_config_id}

Update Agent Config

path Parameters

agent_config_id: string

query Parameters

task_id: string

Optional

If set, after persisting the patch we shallow-merge the changed fields into this task's params column on Agentex so the worker picks up the new values on its next turn. Caller-provided context — Agentex enforces task ownership via its own auth, so the side-effect no-ops if the caller doesn't own the task.

Response fields

id: string

allowed_tools: Array<string>

created_at: string

(format: date-time)

harness: string

model: string

name: string

system_prompt: string

updated_at: string

(format: date-time)

description: string

Optional

object: "agent_config"

Optional

(default: "agent_config")

Request example

curl https://api.egp.scale.com/v5/agent_configs/$AGENT_CONFIG_ID \
    -X PATCH \
    -H 'Content-Type: application/json' \
    -H "x-api-key: $SGP_API_KEY" \
    -d '{}'

200Example

{
  "id": "id",
  "allowed_tools": [
    "string"
  ],
  "created_at": "2019-12-27T18:11:19.117Z",
  "harness": "harness",
  "model": "model",
  "name": "name",
  "system_prompt": "system_prompt",
  "updated_at": "2019-12-27T18:11:19.117Z",
  "description": "description",
  "object": "agent_config"
}

Delete Agent Config -> { id, deleted, object }

delete/v5/agent_configs/{agent_config_id}

Delete Agent Config

Domain types

AgentConfigCreateResponse = { id, allowed_tools, created_at, 7 more... }

AgentConfigDeleteResponse = { id, deleted, object }

AgentConfigListMcpToolsResponse = Array<"Slack" | "Linear" | "GitHub" | 7 more...>

AgentConfigListResponse = { id, allowed_tools, created_at, 7 more... }

AgentConfigRetrieveResponse = { id, allowed_tools, created_at, 7 more... }

AgentConfigUpdateResponse = { id, allowed_tools, created_at, 7 more... }