API reference

List, create, update, and delete configured agents.

Use harness management endpoints from trusted server code or an authorized admin surface.

Endpoints

GET /v1/harnesses lists configured agents visible to the Workspace key.
POST /v1/harnesses creates a configured agent.
GET /v1/harnesses/{id} reads one configured agent.
PUT /v1/harnesses/{id} updates one configured agent.
DELETE /v1/harnesses/{id} deletes one configured agent.

Create shape

Create configured agent

POST /v1/harnesses
Content-Type: application/json

{
  "name": "Contract Review Agent",
  "base": "claude-code",
  "default_model": "<allowed model id>",
  "system_prompt": "<runtime-agent instructions>",
  "mcp_servers": [],
  "skills": []
}