Skip to content
Vocapable Developers

Read one immutable receptionist intelligence revision

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

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
agent_id
required
Agent Id
string
version
required
Version
integer

Responses

Section titled “Responses”

200

Section titled “200”

Successful Response

Media typeapplication/json
ReceptionistIntelligenceVersionResource
object
id
required
Id
string
receptionist_intelligence_id
required
Receptionist Intelligence Id
string
version
required
Version
integer
content_hash
required
Content Hash
string
source_ids
Source Ids
Array<string>
compiled_knowledge
required
Compiled Knowledge
string
compiled_character_count
required
Compiled Character Count
integer
compiled_token_count
required
Compiled Token Count
integer
location_token_counts
Location Token Counts
object
created_at
required
Created At
string format: date-time
draft
required
ReceptionistIntelligenceDraft

The customer-editable intelligence document for one receptionist.

object
business_name
required
Business Name
string
>= 1 characters <= 200 characters
business_summary
required
Business Summary
string
>= 1 characters <= 2000 characters
business_summary_source_refs
Business Summary Source Refs
Array<string>
<= 20 items
locations
Locations
Array<object>
<= 50 items
ReceptionistLocation

A stable business-location reference used by a phone line’s AI policy step.

object
ref
required
Ref
string
/^[a-z][a-z0-9_-]{0,63}$/
name
required
Name
string
>= 1 characters <= 160 characters
address
Any of:
string
<= 500 characters
phone
Any of:
string
<= 64 characters
service_area
Any of:
string
<= 500 characters
facts
Facts
Array<string>
<= 30 items
source_refs
Source Refs
Array<string>
<= 20 items
services
Services
Array<object>
<= 100 items
ReceptionistService

One service the receptionist may describe without inventing availability.

object
name
required
Name
string
>= 1 characters <= 160 characters
description
required
Description
string
>= 1 characters <= 1000 characters
availability_note
Any of:
string
<= 500 characters
source_refs
Source Refs
Array<string>
<= 20 items
pricing_policy
Any of:
string
<= 2000 characters
pricing_policy_source_refs
Pricing Policy Source Refs
Array<string>
<= 20 items
faqs
Faqs
Array<object>
<= 100 items
ReceptionistFaq

An approved caller question and its grounded spoken answer.

object
question
required
Question
string
>= 1 characters <= 500 characters
answer
required
Answer
string
>= 1 characters <= 2000 characters
source_refs
Source Refs
Array<string>
<= 20 items
customer_policies
Customer Policies
Array<object>
<= 100 items
ReceptionistPolicyFact

A named business policy, distinct from platform safety/compliance controls.

object
name
required
Name
string
>= 1 characters <= 160 characters
value
required
Value
string
>= 1 characters <= 2000 characters
source_refs
Source Refs
Array<string>
<= 20 items
supported_intents
Supported Intents
Array<string>
<= 50 items
tone
Any of:
string
<= 500 characters
escalation_rules
Any of:
string
<= 2000 characters
escalation_rules_source_refs
Escalation Rules Source Refs
Array<string>
<= 20 items
prohibited_claims
Prohibited Claims
Array<string>
<= 50 items
approved_actions
Approved Actions
Array<string>
Allowed values: check_calendar book_meeting send_sms send_verification_code verify_identity record_sms_consent take_message open_ticket update_lead record_survey_answer confirm_shift record_shift_response record_qualification schedule_callback transfer_to_human record_optout end_call custom_webhook
sources
Sources
Array<object>
ReceptionistSourceSummary
object
id
required
Id
string
kind
required
Kind
string
Allowed values: document website
label
required
Label
string
source_url
Any of:
string
provenance
required
Provenance
string
Allowed values: customer_upload customer_website_snapshot
content_hash
required
Content Hash
string
content_characters
required
Content Characters
integer
content_token_count
required
Content Token Count
integer
extraction_report
required
ReceptionistSourceExtractionReport

Bounded import evidence shown before a customer promotes facts into the draft.

object
title
Any of:
string
<= 500 characters
extracted_characters
required
Extracted Characters
integer
<= 100000
warnings
Warnings
Array<string>
<= 20 items
refresh_status
required
Refresh Status
string
Allowed value: manual_refresh_required
refresh_of_source_id
Any of:
string
captured_at
required
Captured At
string format: date-time
review_status
required
Review Status
string
Allowed values: pending approved rejected
review_note
Any of:
string
reviewed_at
Any of:
string format: date-time
approved_at
Any of:
string format: date-time
created_at
required
Created At
string format: date-time
Example
{
  "draft": {
    "approved_actions": [
      "check_calendar"
    ]
  },
  "sources": [
    {
      "kind": "document",
      "provenance": "customer_upload",
      "refresh_status": "manual_refresh_required",
      "review_status": "pending"
    }
  ]
}

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": {}
    }
  ]
}