---
title: "List Custom Harnesses"
method: GET
path: "/v1/custom-harnesses/"
tags: ["Diamond", "custom-harnesses"]
---

# List Custom Harnesses

`GET /v1/custom-harnesses/`

## Request

- The document declares no server URL.
- Auth: none declared
- TypeScript: <https://skmtc.dev/vijilai/apis/vijil-console-api-combined/docs/v1/custom-harnesses/get.ts> (a function with typed inputs; its response is checked against the schema)

List custom harnesses for the specified team with pagination and filtering.

Returns paginated list of harnesses owned by the specified team.
Supports filtering by status.

Requires agent:read permission.

## Query parameters

- `team_id` string, uuid, nullable: Team ID (required)
- `limit` integer: Maximum number of results (default 10)
- `offset` integer: Number of results to skip for paging
- `status` 'draft' | 'active' | 'archived' | 'failed': Status values for custom harnesses.
- `agent_id` string, uuid, nullable: Filter by agent ID

## Response `200`

Successful Response

- CustomHarnessListResponse: Response model for paginated list of custom harnesses.
  - `results` CustomHarnessListItem[], required
    - `id` string, uuid, required
    - `name` string, required
    - `description` string, nullable
    - `status` 'draft' | 'active' | 'archived' | 'failed', required: Status values for custom harnesses.
    - `created_at` integer, required
    - `updated_at` integer, required
    - `agent_id` string, uuid, required
    - `agent_name` string, nullable
    - `policy_ids` string[]
    - `persona_ids` string[]
  - `total` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/vijilai/apis/vijil-console-api-combined.md) - [All operations](https://skmtc.dev/vijilai/apis/vijil-console-api-combined/llms.txt) - [OpenAPI document](https://skmtc.dev/vijilai/apis/vijil-console-api-combined/revisions/a8b2ee2b2d06?raw)