Skip to main content
POST

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}$

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.