Harnesses

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.