Skip to content
Vocapable Developers

Read receptionist release readiness, evidence status, and rollback availability

GET
/v1/agents/{agent_id}/receptionist-release
curl --request GET \
  --url https://api.vocapable.com/v1/agents/example/receptionist-release \
  --header 'Authorization: Bearer <token>'

Expose a compact control-center view without leaking sealed prompt knowledge.

A passing scripted replay keeps its historic meaning (publish-ready), while production_ready requires the separate live-model and carrier evidence that a silent or misrouted PSTN session actually depends on.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
agent_id
required
Agent Id
string

Responses

Section titled “Responses”

200

Section titled “200”

Successful Response

Media typeapplication/json
ReceptionistReleaseStatus

Current publish/rollback state without exposing the sealed prompt evidence.

object
agent_definition_id
required
Agent Definition Id
string
active_version
Any of:
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
voice_profile_id
Any of:
string
knowledge_pack_version_id
Any of:
string
receptionist_intelligence_version_id
Any of:
string
receptionist_release_status
Receptionist Release Status
string
default: not_applicable
Allowed values: not_applicable unqualified qualified draining
receptionist_capability_manifest_hash
Any of:
string
receptionist_rendered_token_budget
Any of:
object
key
additional properties
any
receptionist_live_preflight_eval_run_id
Any of:
string
receptionist_canary_route_fingerprint
Any of:
string
receptionist_qualified_at
Any of:
string format: date-time
compliance_profile_id
required
Compliance Profile Id
string
gate_eval_run_id
required
Gate Eval Run Id
string
published_by
Any of:
string
published_at
required
Published At
string format: date-time
rollback_candidate
Any of:
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
voice_profile_id
Any of:
string
knowledge_pack_version_id
Any of:
string
receptionist_intelligence_version_id
Any of:
string
receptionist_release_status
Receptionist Release Status
string
default: not_applicable
Allowed values: not_applicable unqualified qualified draining
receptionist_capability_manifest_hash
Any of:
string
receptionist_rendered_token_budget
Any of:
object
key
additional properties
any
receptionist_live_preflight_eval_run_id
Any of:
string
receptionist_canary_route_fingerprint
Any of:
string
receptionist_qualified_at
Any of:
string format: date-time
compliance_profile_id
required
Compliance Profile Id
string
gate_eval_run_id
required
Gate Eval Run Id
string
published_by
Any of:
string
published_at
required
Published At
string format: date-time
current_draft_hash
Any of:
string
current_gate
Any of:
ReleaseGateEvaluation

A customer-visible release-gate request and its immutable replay verdict.

The request snapshot remains in the restricted eval ledger rather than being echoed wholesale to a browser. These fields show which draft revision the worker evaluated, which built-in dataset it used, and every assertion result once it settles.

object
id
required
Id
string
agent_definition_id
required
Agent Definition Id
string
status
required
Status
string
Allowed values: queued running completed failed
mode
required
Mode
string
Allowed values: scripted_stand_in routing_chain
draft_hash
required
Draft Hash
string
draft_updated_at
required
Draft Updated At
string format: date-time
dataset_ref
Any of:
string
results
required
Results
object
key
additional properties
any
aggregate_score
Any of:
string
/^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$/
passed
required
Passed
boolean
created_at
required
Created At
string format: date-time
current_live_model_preflight
Any of:
ReleaseGateEvaluation

A customer-visible release-gate request and its immutable replay verdict.

The request snapshot remains in the restricted eval ledger rather than being echoed wholesale to a browser. These fields show which draft revision the worker evaluated, which built-in dataset it used, and every assertion result once it settles.

object
id
required
Id
string
agent_definition_id
required
Agent Definition Id
string
status
required
Status
string
Allowed values: queued running completed failed
mode
required
Mode
string
Allowed values: scripted_stand_in routing_chain
draft_hash
required
Draft Hash
string
draft_updated_at
required
Draft Updated At
string format: date-time
dataset_ref
Any of:
string
results
required
Results
object
key
additional properties
any
aggregate_score
Any of:
string
/^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$/
passed
required
Passed
boolean
created_at
required
Created At
string format: date-time
live_model_preflight_evidence
Any of:
ReceptionistLiveModelPreflightEvidence

The non-scripted serving proof required before a receptionist is production-ready.

This is persisted under eval_runs.results.live_model_preflight by an operational routing-chain worker. It is intentionally structured so a generic successful model replay cannot be misread as a proof that the exact production request fits and tools can continue after a result.

object
capability_manifest_hash
required
Capability Manifest Hash
string
/^[0-9a-f]{64}$/
rendered_token_budget
required
ReceptionistRenderedTokenBudget

Exact serving-envelope evidence captured by a live-model preflight.

object
context_capacity_tokens
required
Context Capacity Tokens
integer
>= 1
rendered_prompt_tokens
required
Rendered Prompt Tokens
integer
completion_reserve_tokens
required
Completion Reserve Tokens
integer
>= 1
requested_tokens
required
Requested Tokens
integer
>= 1
request_fits
required
Request Fits
boolean
nonempty_stream
required
Nonempty Stream
boolean
automatic_tool_choice
required
Automatic Tool Choice
boolean
automatic_tool_call
required
Automatic Tool Call
boolean
tool_result_continuation
required
Tool Result Continuation
boolean
parser_name
required
Parser Name
string
>= 1 characters <= 100 characters
parser_validated
required
Parser Validated
boolean
authenticated_runtime_access
required
Authenticated Runtime Access
boolean
loopback_only_access
required
Loopback Only Access
boolean
publish_ready
required
Publish Ready
boolean
rollback_ready
required
Rollback Ready
boolean
production_ready
Production Ready
boolean
checks
Checks
Array<object>
ReceptionistReleaseCheck

One server-derived readiness fact for a receptionist release.

object
key
required
Key
string
status
required
Status
string
Allowed values: ready pending blocked
detail
required
Detail
string
Example
{
  "active_version": {
    "action_confirmation_policy": "legacy_v0",
    "receptionist_release_status": "not_applicable"
  },
  "rollback_candidate": {
    "action_confirmation_policy": "legacy_v0",
    "receptionist_release_status": "not_applicable"
  },
  "current_gate": {
    "status": "queued",
    "mode": "scripted_stand_in"
  },
  "current_live_model_preflight": {
    "status": "queued",
    "mode": "scripted_stand_in"
  },
  "production_ready": false,
  "checks": [
    {
      "status": "ready"
    }
  ]
}

422

Section titled “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
Examplegenerated
{
  "detail": [
    {
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example",
      "input": "example",
      "ctx": {}
    }
  ]
}