Immediately restore a policy-compatible healthy receptionist snapshot

POST

/v1/agents/{agent_id}/receptionist-release/rollback

curl --request POST \
  --url https://api.vocapable.com/v1/agents/example/receptionist-release/rollback \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "target_version": 1 }'

Clone a prior healthy snapshot into a new active immutable version.

The prior row is never mutated. New inbound calls follow the definition’s new latest version, existing calls retain their original pinned version, and the endpoint refuses if any current policy would select a location missing from the rollback target.

Authorizations

• HTTPBearer

Parameters

Path Parameters

agent_id

required

Agent Id

string

Header Parameters

Idempotency-Key

Any of:

string

string

null

null

Unique key for this request, so a retry replays the original result instead of repeating the work. Stored for 24 hours; a replayed response carries Idempotent-Replay: true. A UUID is the documented shape.

Request Body^required

Media typeapplication/json

ReceptionistRollbackRequest

Restore a previously healthy receptionist snapshot; omitted selects the predecessor.

object

target_version

Any of:

integer

integer

>= 1

null

null

Example^generated

{
  "target_version": 1
}

Responses

200

Successful Response

Media typeapplication/json

ReceptionistRollbackResult

A new active immutable snapshot cloned from a verified prior release.

object

agent_definition_id

required

Agent Definition Id

string

restored_from_version

required

AgentVersionSummary

An immutable published snapshot, as a list row.

object

id

required

Id

string

agent_definition_id

required

Agent Definition Id

string

version

required

Version

integer

content_hash

required

Content Hash

string

action_confirmation_policy

Action Confirmation Policy

string

default: legacy_v0

Allowed values: legacy_v0 exact_action_v1 exact_action_v2

max_call_seconds

required

Max Call Seconds

integer

stock_voice_id

Any of:

string

string

null

null

voice_profile_id

Any of:

string

string

null

null

knowledge_pack_version_id

Any of:

string

string

null

null

receptionist_intelligence_version_id

Any of:

string

string

null

null

receptionist_release_status

Receptionist Release Status

string

default: not_applicable

Allowed values: not_applicable unqualified qualified draining

receptionist_capability_manifest_hash

Any of:

string

string

null

null

receptionist_rendered_token_budget

Any of:

object

object

key

additional properties

any

null

null

receptionist_live_preflight_eval_run_id

Any of:

string

string

null

null

receptionist_canary_route_fingerprint

Any of:

string

string

null

null

receptionist_qualified_at

Any of:

string

string format: date-time

null

null

compliance_profile_id

required

Compliance Profile Id

string

gate_eval_run_id

required

Gate Eval Run Id

string

published_by

Any of:

string

string

null

null

published_at

required

Published At

string format: date-time

active_version

required

AgentVersionSummary

An immutable published snapshot, as a list row.

object

id

required

Id

string

agent_definition_id

required

Agent Definition Id

string

version

required

Version

integer

content_hash

required

Content Hash

string

action_confirmation_policy

Action Confirmation Policy

string

default: legacy_v0

Allowed values: legacy_v0 exact_action_v1 exact_action_v2

max_call_seconds

required

Max Call Seconds

integer

stock_voice_id

Any of:

string

string

null

null

voice_profile_id

Any of:

string

string

null

null

knowledge_pack_version_id

Any of:

string

string

null

null

receptionist_intelligence_version_id

Any of:

string

string

null

null

receptionist_release_status

Receptionist Release Status

string

default: not_applicable

Allowed values: not_applicable unqualified qualified draining

receptionist_capability_manifest_hash

Any of:

string

string

null

null

receptionist_rendered_token_budget

Any of:

object

object

key

additional properties

any

null

null

receptionist_live_preflight_eval_run_id

Any of:

string

string

null

null

receptionist_canary_route_fingerprint

Any of:

string

string

null

null

receptionist_qualified_at

Any of:

string

string format: date-time

null

null

compliance_profile_id

required

Compliance Profile Id

string

gate_eval_run_id

required

Gate Eval Run Id

string

published_by

Any of:

string

string

null

null

published_at

required

Published At

string format: date-time

checked_policy_number_ids

Checked Policy Number Ids

Array<string>

Example

{
  "restored_from_version": {
    "action_confirmation_policy": "legacy_v0",
    "receptionist_release_status": "not_applicable"
  },
  "active_version": {
    "action_confirmation_policy": "legacy_v0",
    "receptionist_release_status": "not_applicable"
  }
}

422

Validation Error

Media typeapplication/json

HTTPValidationError

object

detail

Detail

Array<object>

ValidationError

object

loc

required

Location

Array

msg

required

Message

string

type

required

Error Type

string

input

Input

ctx

Context

object

Example^generated

{
  "detail": [
    {
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example",
      "input": "example",
      "ctx": {}
    }
  ]
}