Sign in

v1

latestOpenAPI 3.1.0raw.githubusercontent.com2026-04-21149158448.6 KB
Diamond
custom-harnesses

Create Custom Harness

Create a new custom harness.

Creates a harness in 'draft' status. The harness can be configured with an agent, personas, and policies before being activated.

Note: Harnesses are immutable once created - they cannot be updated.

Requires agent:write permission.

post/v1/custom-harnesses/

Query parameters

team_idstring uuid nullable

Team ID (required)

Team ID (required)

Request body

idstring uuid nullable
namestring required
descriptionstring nullable
agent_idstring uuid required
persona_idsstring[]
policy_idsstring[]
system_promptstring nullable

AUT description or system prompt for harness generation. If not provided, agent description will be used.

Response

Successful Response

idstring uuid required
team_idstring uuid required
namestring required
descriptionstring nullable
agent_idstring uuid required
persona_idsstring[]
policy_idsstring[]
status'draft' | 'active' | 'archived' | 'failed'

Status values for custom harnesses.

workflow_idstring uuid nullable

Reference to the latest workflow that generated this harness. Enables lookup of workflow status by harness_id. Supports future 'regenerate harness' scenarios.

s3_keystring nullable
generated_atinteger nullable
prompt_countinteger nullable
created_atinteger required
updated_atinteger required
created_bystring uuid required
creation_errorstring nullable