Skip to main content
GET
/
v1
/
custom-harnesses
List Custom Harnesses
curl --request GET \
  --url https://api.example.com/v1/custom-harnesses/
{
  "results": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "status": "draft",
      "created_at": 123,
      "updated_at": 123,
      "agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "description": "<string>",
      "agent_name": "<string>",
      "policy_ids": [
        "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      ],
      "persona_ids": [
        "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      ]
    }
  ],
  "total": 123
}

Query Parameters

team_id
string<uuid> | null

Team ID (required)

limit
integer
default:10

Maximum number of results (default 10)

Required range: 1 <= x <= 100
offset
integer
default:0

Number of results to skip for paging

Required range: x >= 0
status
enum<string> | null

Filter by status Status values for custom harnesses.

Available options:
draft,
active,
archived,
failed
agent_id
string<uuid> | null

Filter by agent ID

Response

Successful Response

Response model for paginated list of custom harnesses.

results
CustomHarnessListItem · object[]
required
total
integer
required
Last modified on April 21, 2026