vCita Voice Call Recordings API
The Voice Call Recordings API from vCita — 1 operation(s) for voice call recordings.
The Voice Call Recordings API from vCita — 1 operation(s) for voice call recordings.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/vcita:vcita-voice-call-recordings-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Communication Voice Call Recordings API
description: Unified OpenAPI specification for communication domain
version: '3.0'
x-generated:
sourceFiles:
- contact_channels.json
- communication.json
- staff_notification.json
- business_phone_numbers.json
- legacy_v1_communication.json
- activity_message.json
- communication.json
- conversations.json
- notification_template.json
- legacy_v2_communication.json
- messages.json
pathNormalizations:
- file: communication.json
basePath: /business/communication
transformations:
- original: /channels
normalized: /business/communication/channels
basePath: /business/communication
- original: /channels/{uid}
normalized: /business/communication/channels/{uid}
basePath: /business/communication
- original: /messages
normalized: /business/communication/messages
basePath: /business/communication
- original: /messages/{messageUid}
normalized: /business/communication/messages/{messageUid}
basePath: /business/communication
- original: /sessions
normalized: /business/communication/sessions
basePath: /business/communication
- original: /sessions/typing
normalized: /business/communication/sessions/typing
basePath: /business/communication
- original: /sessions/{uid}
normalized: /business/communication/sessions/{uid}
basePath: /business/communication
- file: legacy_v1_communication.json
basePath: /platform/v1
transformations:
- original: /conversations
normalized: /platform/v1/conversations
basePath: /platform/v1
- original: /clients/{client_id}/conversations
normalized: /platform/v1/clients/{client_id}/conversations
basePath: /platform/v1
- original: /messages
normalized: /platform/v1/messages
basePath: /platform/v1
- original: /numbers/dedicated_numbers/assign
normalized: /platform/v1/numbers/dedicated_numbers/assign
basePath: /platform/v1
- original: /numbers/dedicated_numbers/set_two_way_texting_status
normalized: /platform/v1/numbers/dedicated_numbers/set_two_way_texting_status
basePath: /platform/v1
- original: /numbers/twilio
normalized: /platform/v1/numbers/twilio
basePath: /platform/v1
- original: /numbers/twilio/{sub_account_id}
normalized: /platform/v1/numbers/twilio/{sub_account_id}
basePath: /platform/v1
- file: conversations.json
basePath: /v2
transformations:
- original: /conversations/{id}
normalized: /v2/conversations/{id}
basePath: /v2
- file: legacy_v2_communication.json
basePath: /v2
transformations:
- original: /conversations/{conversation_id}/messages
normalized: /v2/conversations/{conversation_id}/messages
basePath: /v2
- file: messages.json
basePath: /business/messaging
transformations:
- original: /v1/channels
normalized: /business/messaging/v1/channels
basePath: /business/messaging
- original: /v1/channels/typing
normalized: /business/messaging/v1/channels/typing
basePath: /business/messaging
pathConflicts: []
componentConflicts:
- type: schema
name: ErrorResponse
resolution: Renamed to ErrorResponse_communication
files:
- merged
- communication.json
- type: schema
name: ErrorResponse
resolution: Renamed to ErrorResponse_staff_notification
files:
- merged
- staff_notification.json
- type: schema
name: Response
resolution: Renamed to Response_business_phone_numbers
files:
- merged
- business_phone_numbers.json
- type: schema
name: ErrorResponse
resolution: Renamed to ErrorResponse_business_phone_numbers
files:
- merged
- business_phone_numbers.json
- type: schema
name: ErrorResponse
resolution: Renamed to ErrorResponse_activity_message
files:
- merged
- activity_message.json
- type: schema
name: Response
resolution: Renamed to Response_communication
files:
- merged
- communication.json
- type: schema
name: ErrorResponse
resolution: Renamed to ErrorResponse_conversations
files:
- merged
- conversations.json
totalPaths: 36
totalComponents: 50
servers:
- url: https://api.vcita.biz
description: Unified API Gateway server
tags:
- name: Voice Call Recordings
paths:
/v3/communication/voice_call_recordings/{uid}:
put:
operationId: RecordingsController_updateVoiceCallRecording
summary: Update a VoiceCallRecording
parameters:
- name: uid
required: true
in: path
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateVoiceCallRecording'
responses:
'200':
description: Returns a voiceCall entity
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/Response'
- properties:
data:
type: object
properties:
uid:
type: string
description: Unique identifier of the VoiceCall object
duration:
type: integer
description: Duration of the call in seconds
created_at:
type: string
description: The time the call was created
updated_at:
type: string
description: The time the call was last updated
status:
type: string
enum:
- INCOMING_CALL
- ANSWERED_BY_STAFF
- MISSED
- ANSWERED_BY_CALLS_PROVIDER
- MISSED_CALL_HANDLED
- VOICEMAIL
description: The status of the call (e.g., "ANSWERED_BY_STAFF")
direction:
type: string
enum:
- INBOUND
- OUTBOUND
description: The direction of the call. INBOUND for incoming calls to the business, OUTBOUND for outgoing calls from the business. Values are uppercase (e.g., "INBOUND").
staff_uid:
type: string
description: Unique identifier of the staff member who answered the call
client_uid:
type: string
description: Unique identifier of the client who made the call
from_number:
type: string
description: The phone number the call was made from
to_number:
type: string
description: The phone number the call was made to
call_summary:
type: string
description: Text summary of the call
recording:
type: object
properties:
uid:
type: string
description: Unique identifier of the recording entity (e.g., "rec-abc123xyz")
recordingUrl:
type: string
description: Pre-signed URL to access the recording file (e.g., "https://example.com/recordings/presigned-url")
size:
type: number
description: The size of the recording in bytes (e.g., 1048576)
duration:
type: number
description: The duration of the recording in seconds (e.g., 300)
recording_played:
type: boolean
description: Whether the call recording has been played (e.g., false)
recording_type:
type: string
description: The type of the recording
enum:
- CALL
- VOICEMAIL
required:
- uid
- size
- duration
- recording_type
example:
uid: rec-abc123xyz
recordingUrl: https://example.com/recordings/presigned-url
size: 1048576
duration: 300
recording_played: false
recording_type: CALL
description: The call recording details
external_app_url:
type: string
description: Link to an application page with additional details about the call (e.g., "https://example.com/call-details")
external_app_name:
type: string
description: The name of the external application that originated or manages the call (e.g., "my.pa")
source_id:
type: string
description: A unique source identifier for the call from the provider system (e.g., "call-src-001")
external_uuid:
type: string
description: An external unique identifier for the call conversation from the provider system (e.g., "ext-call-001")
handled_by_staff_uid:
type: string
description: The unique identifier of the staff who handled the call
handled_at:
type: string
description: The date and time when the call was handled
format: date-time
deleted_at:
type: string
description: Time the call was deleted - is null if the call is not deleted
transcript_status:
type: string
nullable: true
enum:
- IN_PROGRESS
- DONE
- FAILED
description: Processing status of the associated transcript. IN_PROGRESS means the transcript is being generated, DONE means it is ready, FAILED means generation failed (e.g., "DONE")
example:
uid: d290f1ee-6c54-4b01-90e6-d701748f0851
created_at: '2021-07-20T14:00:00.000Z'
updated_at: '2021-07-20T14:00:00.000Z'
duration: 120
status: ANSWERED_BY_STAFF
direction: INBOUND
staff_uid: d290f1ee-6c54-4b01-90e6-d701748f0851
client_uid: d290f1ee-6c54-4b01-90e6-d701748f0851
from_number: '183466347342'
to_number: '183466347342'
call_summary: Client called to ask about their account balance
recording:
uid: rec-abc123xyz
recordingUrl: https://example.com/recordings/presigned-url
size: 1048576
duration: 300
recording_played: false
recording_type: CALL
external_app_url: https://example.com/call-details
external_app_name: my.pa
source_id: call-src-001
external_uuid: ext-call-001
handled_by_staff_uid: d290f1ee-6c54-4b01-90e6-d701748f0851
handled_at: '2021-07-20T14:00:00.000Z'
deleted_at: null
transcript_status: DONE
description: Represents a phone call record, including participants, status, recording and audit timestamps.
tags:
- Voice Call Recordings
description: '## Overview
Update a VoiceCallRecording Available for **Staff, App, and Directory tokens**.'
security:
- Bearer: []
delete:
operationId: RecordingsController_deleteVoiceCallRecording
summary: Delete a VoiceCallRecording
description: '## Overview
Deletes a voice call recording and returns a voiceCall entity Available for **Staff, App, and Directory tokens**.'
parameters:
- name: uid
required: true
in: path
schema:
type: string
responses:
'200':
description: Returns a voiceCall entity
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/Response'
- properties:
data:
type: object
properties:
uid:
type: string
description: Unique identifier of the VoiceCall object
duration:
type: integer
description: Duration of the call in seconds
created_at:
type: string
description: The time the call was created
updated_at:
type: string
description: The time the call was last updated
status:
type: string
enum:
- INCOMING_CALL
- ANSWERED_BY_STAFF
- MISSED
- ANSWERED_BY_CALLS_PROVIDER
- MISSED_CALL_HANDLED
- VOICEMAIL
description: The status of the call (e.g., "ANSWERED_BY_STAFF")
direction:
type: string
enum:
- INBOUND
- OUTBOUND
description: The direction of the call. INBOUND for incoming calls to the business, OUTBOUND for outgoing calls from the business. Values are uppercase (e.g., "INBOUND").
staff_uid:
type: string
description: Unique identifier of the staff member who answered the call
client_uid:
type: string
description: Unique identifier of the client who made the call
from_number:
type: string
description: The phone number the call was made from
to_number:
type: string
description: The phone number the call was made to
call_summary:
type: string
description: Text summary of the call
recording:
type: object
properties:
uid:
type: string
description: Unique identifier of the recording entity (e.g., "rec-abc123xyz")
recordingUrl:
type: string
description: Pre-signed URL to access the recording file (e.g., "https://example.com/recordings/presigned-url")
size:
type: number
description: The size of the recording in bytes (e.g., 1048576)
duration:
type: number
description: The duration of the recording in seconds (e.g., 300)
recording_played:
type: boolean
description: Whether the call recording has been played (e.g., false)
recording_type:
type: string
description: The type of the recording
enum:
- CALL
- VOICEMAIL
required:
- uid
- size
- duration
- recording_type
example:
uid: rec-abc123xyz
recordingUrl: https://example.com/recordings/presigned-url
size: 1048576
duration: 300
recording_played: false
recording_type: CALL
description: The call recording details
external_app_url:
type: string
description: Link to an application page with additional details about the call (e.g., "https://example.com/call-details")
external_app_name:
type: string
description: The name of the external application that originated or manages the call (e.g., "my.pa")
source_id:
type: string
description: A unique source identifier for the call from the provider system (e.g., "call-src-001")
external_uuid:
type: string
description: An external unique identifier for the call conversation from the provider system (e.g., "ext-call-001")
handled_by_staff_uid:
type: string
description: The unique identifier of the staff who handled the call
handled_at:
type: string
description: The date and time when the call was handled
format: date-time
deleted_at:
type: string
description: Time the call was deleted - is null if the call is not deleted
transcript_status:
type: string
nullable: true
enum:
- IN_PROGRESS
- DONE
- FAILED
description: Processing status of the associated transcript. IN_PROGRESS means the transcript is being generated, DONE means it is ready, FAILED means generation failed (e.g., "DONE")
example:
uid: d290f1ee-6c54-4b01-90e6-d701748f0851
created_at: '2021-07-20T14:00:00.000Z'
updated_at: '2021-07-20T14:00:00.000Z'
duration: 120
status: ANSWERED_BY_STAFF
direction: INBOUND
staff_uid: d290f1ee-6c54-4b01-90e6-d701748f0851
client_uid: d290f1ee-6c54-4b01-90e6-d701748f0851
from_number: '183466347342'
to_number: '183466347342'
call_summary: Client called to ask about their account balance
recording:
uid: rec-abc123xyz
recordingUrl: https://example.com/recordings/presigned-url
size: 1048576
duration: 300
recording_played: false
recording_type: CALL
external_app_url: https://example.com/call-details
external_app_name: my.pa
source_id: call-src-001
external_uuid: ext-call-001
handled_by_staff_uid: d290f1ee-6c54-4b01-90e6-d701748f0851
handled_at: '2021-07-20T14:00:00.000Z'
deleted_at: null
transcript_status: DONE
description: Represents a phone call record, including participants, status, recording and audit timestamps.
tags:
- Voice Call Recordings
security:
- Bearer: []
components:
schemas:
Response:
properties:
data:
type: object
success:
type: boolean
required:
- success
- data
type: object
UpdateVoiceCallRecording:
type: object
properties:
recording_played:
type: boolean
description: Whether the call recording has been played (e.g., true)
securitySchemes:
Bearer:
type: http
scheme: bearer
bearerFormat: JWT
description: 'Provide a valid bearer token in the Authorization header. Example: ''Authorization: Bearer {app_token}'''
Conversations:
type: http
scheme: bearer
bearerFormat: JWT
description: 'Provide a valid staff bearer token in the Authorization header. Example: ''Authorization: Bearer {staff_token}''.'
x-provenance:
method: searched
source: https://developers.intandem.tech:443/reference
harvested: '2026-11-15'
tool: harvest-readme-openapi.py
note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
assembled_from:
- https://developers.intandem.tech/reference/availablephonenumberscontroller_findall.md
- https://developers.intandem.tech/reference/businessphonenumberscontroller_create.md
- https://developers.intandem.tech/reference/businessphonenumberscontroller_findall.md
- https://developers.intandem.tech/reference/businessphonenumberscontroller_findone.md
- https://developers.intandem.tech/reference/businessphonenumberscontroller_update.md
- https://developers.intandem.tech/reference/channelscontroller_create.md
- https://developers.intandem.tech/reference/channelscontroller_deletechannel.md
- https://developers.intandem.tech/reference/channelscontroller_updatechannel.md
- https://developers.intandem.tech/reference/contactchannelscontroller_index.md
- https://developers.intandem.tech/reference/delete_platform-v1-numbers-twilio-sub-account-id.md
- https://developers.intandem.tech/reference/delete_v3-communication-notification-templates-uid.md
- https://developers.intandem.tech/reference/get_platform-v1-clients-client-id-conversations-1.md
- https://developers.intandem.tech/reference/get_platform-v1-conversations.md
- https://developers.intandem.tech/reference/get_v2-conversations-conversation-id-messages.md
- https://developers.intandem.tech/reference/get_v3-communication-notification-templates-uid.md
- https://developers.intandem.tech/reference/get_v3-communication-notification-templates.md
- https://developers.intandem.tech/reference/get_v3-communication-staff-notifications-uid.md
- https://developers.intandem.tech/reference/getstaffnotificationstats.md
- https://developers.intandem.tech/reference/listactivitymessages.md
- https://developers.intandem.tech/reference/liststaffnotifications.md
- https://developers.intandem.tech/reference/messagescontroller_createmessage.md
- https://developers.intandem.tech/reference/messagescontroller_updatestatus.md
- https://developers.intandem.tech/reference/post_business-messaging-v1-channels-typing.md
- https://developers.intandem.tech/reference/post_business-messaging-v1-channels.md
- https://developers.intandem.tech/reference/post_platform-v1-messages.md
- https://developers.intandem.tech/reference/post_platform-v1-numbers-dedicated-numbers-assign.md
- https://developers.intandem.tech/reference/post_platform-v1-numbers-twilio.md
- https://developers.intandem.tech/reference/post_v3-communication-notification-templates.md
- https://developers.intandem.tech/reference/post_v3-communication-staff-notifications.md
- https://developers.intandem.tech/reference/put_platform-v1-numbers-dedicated-numbers-set-two-way-texting-status.md
- https://developers.intandem.tech/reference/put_v2-conversations-id.md
- https://developers.intandem.tech/reference/put_v3-communication-notification-templates-uid.md
- https://developers.intandem.tech/reference/quotascontroller_getquota.md
- https://developers.intandem.tech/reference/recordingscontroller_deletevoicecallrecording.md
- https://developers.intandem.tech/reference/recordingscontroller_updatevoicecallrecording.md
- https://developers.intandem.tech/reference/reportscontroller_getvoicecallstats.md
- https://developers.intandem.tech/reference/sendactivitymessage.md
- https://developers.intandem.tech/reference/sessionscontroller_createsession.md
- https://developers.intandem.tech/reference/sessionscontroller_getsession.md
- https://developers.intandem.tech/reference/sessionscontroller_logicdelete.md
- https://developers.intandem.tech/reference/sessionscontroller_updatestatus.md
- https://developers.intandem.tech/reference/sessionstypingcontroller_typingstatus.md
- https://developers.intandem.tech/reference/settingscontroller_create.md
- https://developers.intandem.tech/reference/settingscontroller_delete.md
- https://developers.intandem.tech/reference/settingscontroller_get.md
- https://developers.intandem.tech/reference/settingscontroller_update.md
- https://developers.intandem.tech/reference/transcriptcontroller_gettranscript.md
- https://developers.intandem.tech/reference/voicecallscontroller_create.md
- https://developers.intandem.tech/reference/voicecallscontroller_get.md
- https://developers.intandem.tech/reference/voicecallscontroller_getall.md
- https://developers.intandem.tech/reference/voicecallscontroller_update.md
- https://developers.intandem.tech:443/reference/availablephonenumberscontroller_findall.md
- https://developers.intandem.tech:443/reference/businessphonenumberscontroller_create.md
- https://developers.intandem.tech:443/reference/businessphonenumberscontroller_findall.md
- https://developers.intandem.tech:443/reference/businessphonenumberscontroller_findone.md
- https://developers.intandem.tech:443/reference/businessphonenumberscontroller_update.md
- https://developers.intandem.tech:443/reference/channelscontroller_create.md
- https://developers.intandem.tech:443/reference/channelscontroller_deletechannel.md
- https://developers.intandem.tech:443/reference/channelscontroller_updatechannel.md
- https://developers.intandem.tech:443/reference/contactchannelscontroller_index.md
- https://developers.intandem.tech:443/reference/delete_platform-v1-numbers-twilio-sub-account-id.md
- https://developers.intandem.tech:443/reference/delete_v3-communication-notification-templates-uid.md
- https://developers.intandem.tech:443/reference/get_platform-v1-clients-client-id-conversations-1.md
- https://developers.intandem.tech:443/reference/get_platform-v1-conversations.md
- https://developers.intandem.tech:443/reference/get_v2-conversations-conversation-id-messages.md
- https://developers.intandem.tech:443/reference/get_v3-communication-notification-templates-uid.md
- https://developers.intandem.tech:443/reference/get_v3-communication-notification-templates.md
- https://developers.intandem.tech:443/reference/get_v3-communication-staff-notifications-uid.md
- https://developers.intandem.tech:443/reference/getstaffnotificationstats.md
- https://developers.intandem.tech:443/reference/listactivitymessages.md
- https://developers.intandem.tech:443/reference/liststaffnotifications.md
- https://developers.intandem.tech:443/reference/messagescontroller_createmessage.md
- https://developers.intandem.tech:443/reference/messagescontroller_updatestatus.md
- https://developers.intandem.tech:443/reference/post_business-messaging-v1-channels-typing.md
- https://developers.intandem.tech:443/reference/post_business-messaging-v1-channels.md
- https://developers.intandem.tech:443/reference/post_platform-v1-messages.md
- https://developers.intandem.tech:443/reference/post_platform-v1-numbers-dedicated-numbers-assign.md
- https://developers.intandem.tech:443/reference/post_platform-v1-numbers-twilio.md
- https://developers.intandem.tech:443/reference/post_v3-communication-notification-templates.md
- https://developers.intandem.tech:443/reference/post_v3-communication-staff-notifications.md
- https://developers.intandem.tech:443/reference/put_platform-v1-numbers-dedicated-numbers-set-two-way-texting-status.md
- https://developers.intandem.tech:443/reference/put_v2-conversations-id.md
- https://developers.intandem.tech:443/reference/put_v3-communication-notification-templates-uid.md
- https://developers.intandem.tech:443/reference/quotascontroller_getquota.md
- https://developers.intandem.tech:443/reference/recordingscontroller_deletevoicecallrecording.md
- https://developers.intandem.tech:443/reference/recordingscontroller_updatevoicecallrecording.md
- https://developers.intandem.tech:443/reference/reportscontroller_getvoicecallstats.md
- https://developers.intandem.tech:443/reference/sendactivitymessage.md
- https://developers.intandem.tech:443/reference/sessionscontroller_createsession.md
- https://developers.intandem.tech:443/reference/sessionscontroller_getsession.md
- https://developers.intandem.tech:443/reference/sessionscontroller_logicdelete.md
- https://developers.intandem.tech:443/reference/sessionscontroller_updatestatus.md
- https://developers.intandem.tech:443/reference/sessionstypingcontroller_typingstatus.md
- https://developers.intandem.tech:443/reference/settingscontroller_create.md
- https://developers.intandem.tech:443/reference/settingscontroller_delete.md
- https://developers.intandem.tech:443/reference/settingscontroller_get.md
- https://developers.intandem.tech:443/reference/settingscontroller_update.md
- https://developers.intandem.tech:443/reference/transcriptcontroller_gettranscript.md
- https://developers.intandem.tech:443/reference/voicecallscontroller_create.md
- https://developers.intandem.tech:443/reference/voicecallscontroller_get.md
- https://developers.intandem.tech:443/reference/voicecallscontroller_getall.md
- https://developers.intandem.tech:443/reference/voicecallscontroller_update.md
merge:
pages: 102
deduped: 294
conflicts_kept_first: 0