Agents

Revert agent version

Re-apply a prior version's configuration to the live agent. A revert is forward-only: it mints a new version (change_type=revert) and advances the agent, so the response reflects the agent's new live config. Reverting to the version the agent already points at is rejected with 400.

post/agents/{agent_id}/versions/{version_id}/revert

Request

Base URL
https://api.coval.dev/v1
Auth
API key in header x-api-key

Path parameters

agent_idstring required

Agent resource ID

version_idstring required

ULID of the target version to re-apply

Response

Agent reverted successfully

Example response

{
  "agent": {
    "id": "abc123def456ghi789jklm",
    "customer_agent_id": "my-support-agent",
    "display_name": "Customer Support Agent",
    "model_type": "MODEL_TYPE_VOICE",
    "phone_number": "+1234567890",
    "endpoint": "https://api.example.com/agent",
    "prompt": "You are a helpful customer support agent...",
    "language": "en",
    "attributes": {
      "company_name": "Acme Corp",
      "tier": "enterprise"
    },
    "metadata": {
      "voice": "alloy",
      "model": "gpt-realtime-2"
    },
    "workflows": {},
    "metric_ids": [
      "abc123def456ghi789jklm",
      "def456ghi789jklmabc123"
    ],
    "test_set_ids": [
      "gT5wq2Hn"
    ],
    "knowledge_base_ids": [],
    "tags": [
      "production",
      "voice"
    ],
    "create_time": "2025-10-14T12:00:00Z",
    "update_time": "2025-10-15T14:30:00Z"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.