Skip to main content
GET
/
v1
/
agents
/
{agent_id}
/
mutations
List mutations
curl --request GET \
  --url https://api.coval.dev/v1/agents/{agent_id}/mutations \
  --header 'X-API-Key: <api-key>'
{
  "mutations": [
    {
      "id": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
      "agent_id": "gk3jK9mPq2xRt5vW8yZaBc",
      "display_name": "GPT-4 Fast VAD",
      "description": "Testing faster VAD settings",
      "config_overrides": {
        "voice": "nova",
        "vad_stop_secs": 0.3
      },
      "parameter_values": {
        "voice": "nova",
        "vad_stop_secs": "0.3"
      },
      "create_time": "2025-10-14T12:00:00Z",
      "update_time": "2025-10-15T14:30:00Z"
    },
    {
      "id": "01ARZ3NDEKTSV4RRFFQ69G5FAW",
      "agent_id": "gk3jK9mPq2xRt5vW8yZaBc",
      "display_name": "Claude Model",
      "description": "Testing Claude integration",
      "config_overrides": {
        "model": "claude-3-opus"
      },
      "parameter_values": {
        "model": "claude-3-opus"
      },
      "create_time": "2025-10-13T10:00:00Z",
      "update_time": null
    }
  ],
  "next_page_token": null,
  "total_count": 2
}

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

Query Parameters

page_size
integer
default:50

Maximum number of results per page

Required range: 1 <= x <= 100
page_token
string

Opaque pagination token from previous response

Response

Mutations retrieved successfully

mutations
object[]
required

List of mutation resources

next_page_token
string | null

Token for fetching next page (null if no more results)

Example:

"eyJvZmZzZXQiOjUwfQ=="

total_count
integer

Total count of mutations matching filter

Example:

3