vCita Manage Numbers API
The Manage Numbers API from vCita — 4 operation(s) for manage numbers.
The Manage Numbers API from vCita — 4 operation(s) for manage numbers.
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-manage-numbers-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 Manage Numbers 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: Manage Numbers
paths:
/platform/v1/numbers/dedicated_numbers/assign:
post:
description: '## Overview
Assign Dedicated Number For Account, This API requires the ''enable_dedicated_nexmo_number'' feature flag to be enabled on your account/directory. For additional information please reach out to our support.
Available for **Staff, Directory, and Client tokens**'
parameters: []
responses:
'201':
description: Success
content:
application/json:
example:
data:
data: true
success: true
success: true
summary: Assign Dedicated Number
tags:
- Manage Numbers
x-amazon-apigateway-auth:
type: NONE
x-amazon-apigateway-integration:
httpMethod: POST
responses:
default:
statusCode: '201'
type: http_proxy
uri: https:///platform/v1/numbers/dedicated_numbers/assign
x-auth-type: Application & Application User
requestBody:
content:
application/json:
schema:
properties:
api_key:
type: string
business_uid:
type: string
number:
type: string
number_type:
description: Array of number types to assign. Must be a JSON array (not a scalar string), e.g. ["transactional"] or ["promotional","transactional"].
type: array
items:
type: string
enum:
- promotional
- transactional
required:
- number
- number_type
- api_key
type: object
example:
business_uid: co8yyqp50k0hxzgx
number: '18335653846'
number_type:
- transactional
api_key: <your_api_key>
security:
- Bearer: []
operationId: postPlatformV1NumbersDedicatedNumbersAssign
x-operation-id-source: derived
/platform/v1/numbers/dedicated_numbers/set_two_way_texting_status:
put:
description: '## Overview
Set Two Way Texting Status.
**Prerequisites:**
- Business must have a dedicated number assigned via `POST /platform/v1/numbers/dedicated_numbers/assign` before using this endpoint.
Available for **Staff, App, and Directory tokens**.'
responses:
'200':
description: Success
content:
application/json:
example:
data:
data: inactive
success: true
success: true
'422':
description: Unprocessable Entity - Business does not have a dedicated number assigned
content:
application/json:
example:
success: false
errors:
- code: no_dedicated_number
message: No Dedicated Number Found. Business must have a dedicated number assigned via POST /platform/v1/numbers/dedicated_numbers/assign first.
summary: Set Two Way Texting Status
tags:
- Manage Numbers
x-amazon-apigateway-auth:
type: NONE
x-amazon-apigateway-integration:
httpMethod: PUT
responses:
default:
statusCode: '200'
type: http_proxy
uri: https:///platform/v1/numbers/dedicated_numbers/set_two_way_texting_status
x-auth-type: Application & Application User
security:
- Bearer: []
operationId: putPlatformV1NumbersDedicatedNumbersSetTwoWayTextingStatus
x-operation-id-source: derived
/platform/v1/numbers/twilio:
post:
description: '## Overview
Add a Twilio Number Available for **Staff, App, and Directory tokens**.'
parameters: []
responses:
'201':
description: Success
content:
application/json:
example:
data:
data:
business_uid: 123asd123asd
messaging_id: 123abc
number: '123456789'
sub_account_id: 123aaa
success: true
success: true
summary: Add Twilio Number
tags:
- Manage Numbers
x-amazon-apigateway-auth:
type: NONE
x-amazon-apigateway-integration:
httpMethod: POST
responses:
default:
statusCode: '201'
type: http_proxy
uri: https:///platform/v1/numbers/twilio
x-auth-type: Application & Application User
requestBody:
content:
application/json:
schema:
properties:
business_uid:
type: string
messaging_id:
type: string
number:
type: string
sub_account_id:
type: string
required:
- business_uid
- number
- messaging_id
- sub_account_id
type: object
security:
- Bearer: []
operationId: postPlatformV1NumbersTwilio
x-operation-id-source: derived
/platform/v1/numbers/twilio/{sub_account_id}:
delete:
description: '## Overview
Remove Twilio Number Available for **Staff, App, and Directory tokens**.'
parameters:
- description: Sub Account ID
in: path
name: sub_account_id
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
example:
data:
data:
business_uid: 123asd123asd
messaging_id: 123abc
number: '123456789'
success: true
success: true
summary: Remove Twilio Number
tags:
- Manage Numbers
x-amazon-apigateway-auth:
type: NONE
x-amazon-apigateway-integration:
httpMethod: DELETE
responses:
default:
statusCode: '200'
type: http_proxy
uri: https:///platform/v1/numbers/twilio/{sub_account_id}
x-auth-type: Application & Application User
security:
- Bearer: []
operationId: deletePlatformV1NumbersTwilioBySubAccountId
x-operation-id-source: derived
components:
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