# 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](https://unifiedharnessprotocol.org/spec/harnesses).