Skip to main content
POST

Authorizations

​
X-API-Key
string
header
required

API key for authentication

Headers

​
X-Coval-Workspace-Id
string

Workspace that scopes this operation. When omitted, the organization's active default workspace is used when one can be resolved.

Required string length: 1 - 26

Path Parameters

​
agent_id
string
required

Parent agent ID (22-character ShortUUID)

Pattern: ^[A-Za-z0-9]{22}$

Body

application/json
​
display_name
string
required

Human-readable mutation name (must be unique per agent among active mutations)

Required string length: 1 - 200
Example:

"GPT-4 Fast VAD"

​
description
string
default:""

Optional description of the mutation's purpose

Maximum string length: 2000
Example:

"Testing faster VAD settings with GPT-4"

​
config_overrides
object

Configuration delta to merge with parent agent at runtime. Keys must exist on parent agent config. Max 10KB.

Example:
​
parameter_values
object | null

Flattened key-value pairs for display purposes. If not provided, auto-derived from config_overrides.

Example:

Response

Mutation created successfully

​
mutation
object
required

Agent mutation resource representing a configuration variant.