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": []
}

Open standard

Creating, updating, and deleting configured agents through these endpoints is harness lifecycle management, which UHP places at conformance class Full in its Harnesses chapter. See harness management in the UHP Harnesses chapter.

Create API Key

Ready to run this against a live workspace? Keys take under a minute.