Skip to main content
PATCH

Authorizations

X-API-Key
string
header
required

API key for authentication

Path Parameters

agent_id
string
required

Parent agent ID (22-character ShortUUID)

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

Mutation ID (26-character ULID)

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

Body

application/json

Partial update request.

display_name
string

Human-readable mutation name

Required string length: 1 - 200
Example:

"GPT-4 Slow VAD"

description
string

Optional description

Maximum string length: 2000
Example:

"Updated to use slower VAD settings"

config_overrides
object

Configuration delta (validated against parent agent)

Example:
parameter_values
object

Flattened display values

Example:

Response

Mutation updated successfully

mutation
object
required

Agent mutation resource representing a configuration variant.