{ "openapi": "3.0.3", "info": { "version": "0.8.0", "title": "Channel Manager API", "x-metaTitle": "Vonage Channel Manager API Reference | Vonage API Documentation", "x-metaDescription": "Find quick answers to questions about the Vonage Channel Manager API in this reference guide. Learn more in Vonage's API documentation.", "x-label": "Beta", "description": "The Channel Manager API provides a way of managing configuration and data related to various messaging channels in the Vonage Messages API. Find out more at .", "contact": { "name": "Vonage Developer Relations", "email": "devrel@vonage.com", "url": "https://developer.vonage.com/" }, "license": { "name": "Apache 2.0", "url": "https://www.apache.org/licenses/LICENSE-2.0.html" } }, "servers": [ { "url": "https://api.nexmo.com", "description": "API Server" } ], "paths": { "/v2/whatsapp-manager/subscriptions": { "get": { "summary": "List Notification Subscriptions", "description": "Get a list of all notification subscriptions for the main API key", "operationId": "getNotificationSubscriptions", "tags": [ "WhatsApp Notification Subscriptions" ], "security": [ { "bearerAuth": [] }, { "basicAuth": [] } ], "responses": { "200": { "$ref": "#/components/responses/WhatsAppSubscriptionResponse" }, "401": { "$ref": "#/components/responses/401" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } }, "post": { "summary": "Create a Notification Subscription", "description": "Create a new notification subscription for the main API key", "operationId": "createNotificationSubscription", "tags": [ "WhatsApp Notification Subscriptions" ], "security": [ { "bearerAuth": [] }, { "basicAuth": [] } ], "requestBody": { "$ref": "#/components/requestBodies/WhatsAppCreateSubscriptionNotificationRequest" }, "responses": { "200": { "$ref": "#/components/responses/WhatsAppSubscriptionSingleResponse" }, "400": { "$ref": "#/components/responses/WhatsAppCreateSubscriptionErrorResponse" }, "401": { "$ref": "#/components/responses/401" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } } }, "/v2/whatsapp-manager/subscriptions/{subscription_id}": { "parameters": [ { "$ref": "#/components/parameters/SubscriptionId" } ], "delete": { "summary": "Delete a Notification Subscription", "description": "Delete a notification subscription for the main API key", "operationId": "deleteNotificationSubscription", "tags": [ "WhatsApp Notification Subscriptions" ], "security": [ { "bearerAuth": [] }, { "basicAuth": [] } ], "responses": { "204": { "$ref": "#/components/responses/204" }, "401": { "$ref": "#/components/responses/401" }, "404": { "$ref": "#/components/responses/404" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } } }, "/v1/channel-manager/whatsapp/wabas": { "get": { "summary": "List WhatsApp Business Accounts (WABAs)", "description": "List all WhatsApp Business Accounts (WABAs) that are associated with the Vonage account.", "operationId": "listWhatsAppWabas", "tags": [ "WhatsApp WABAs" ], "security": [ { "bearerAuth": [] }, { "basicAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/PageNumber" }, { "$ref": "#/components/parameters/PageSize" }, { "$ref": "#/components/parameters/Order" } ], "responses": { "200": { "$ref": "#/components/responses/WhatsAppWabaListResponse" }, "400": { "$ref": "#/components/responses/400" }, "401": { "$ref": "#/components/responses/401" }, "422": { "$ref": "#/components/responses/422" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } } }, "/v1/channel-manager/whatsapp/wabas/{waba_id}": { "parameters": [ { "$ref": "#/components/parameters/WhatsAppWabaId" } ], "get": { "summary": "Get a specific WhatsApp Business Account (WABA)", "description": "Retreive details of a specific WhatsApp Business Account (WABA).", "operationId": "getWhatsAppWaba", "tags": [ "WhatsApp WABAs" ], "security": [ { "bearerAuth": [] }, { "basicAuth": [] } ], "responses": { "200": { "$ref": "#/components/responses/WhatsAppWabaResponse" }, "401": { "$ref": "#/components/responses/401" }, "404": { "$ref": "#/components/responses/WhatsAppWabaNotFoundErrorResponse" }, "422": { "$ref": "#/components/responses/422" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } } }, "/v1/channel-manager/whatsapp/wabas/{waba_id}/numbers": { "parameters": [ { "$ref": "#/components/parameters/WhatsAppWabaId" } ], "get": { "summary": "List Numbers for a WhatsApp Business Account (WABA)", "description": "List all Numbers associated with a WhatsApp Business Account (WABA).", "operationId": "listWhatsAppWabaNumbers", "tags": [ "WhatsApp WABAs" ], "security": [ { "bearerAuth": [] }, { "basicAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/PageNumber" }, { "$ref": "#/components/parameters/PageSize" }, { "$ref": "#/components/parameters/Order" } ], "responses": { "200": { "$ref": "#/components/responses/WhatsAppNumbersHalResponse" }, "400": { "$ref": "#/components/responses/400" }, "401": { "$ref": "#/components/responses/401" }, "404": { "$ref": "#/components/responses/WhatsAppWabaNotFoundErrorResponse" }, "422": { "$ref": "#/components/responses/422" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } } }, "/v1/channel-manager/whatsapp/wabas/{waba_id}/numbers/{whatsapp_number}": { "parameters": [ { "$ref": "#/components/parameters/WhatsAppWabaId" }, { "$ref": "#/components/parameters/WhatsAppNumber" } ], "get": { "summary": "Get a specific WhatsApp Business Account (WABA) Number", "description": "Retreive details of a specific Number associated with a WhatsApp Business Account (WABA).", "operationId": "getWhatsAppWabaNumber", "tags": [ "WhatsApp WABAs" ], "security": [ { "bearerAuth": [] }, { "basicAuth": [] } ], "responses": { "200": { "$ref": "#/components/responses/WhatsAppNumbersResponse" }, "400": { "$ref": "#/components/responses/400" }, "401": { "$ref": "#/components/responses/401" }, "404": { "$ref": "#/components/responses/WhatsAppWabaNumberNotFoundErrorResponse" }, "422": { "$ref": "#/components/responses/422" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } } }, "/v1/channel-manager/whatsapp/numbers/{whatsapp_number}/profile": { "parameters": [ { "$ref": "#/components/parameters/WhatsAppNumber" } ], "get": { "summary": "Get the profile for a specific WhatsApp Business Account (WABA) Number", "description": "Retreive details of the profile for a specific Number associated with a WhatsApp Business Account (WABA).", "operationId": "getWhatsAppWabaNumberProfile", "tags": [ "WhatsApp WABAs" ], "security": [ { "bearerAuth": [] }, { "basicAuth": [] } ], "responses": { "200": { "$ref": "#/components/responses/WhatsAppNumberProfileResponse" }, "400": { "$ref": "#/components/responses/400" }, "401": { "$ref": "#/components/responses/401" }, "404": { "$ref": "#/components/responses/WhatsAppProfileNotFoundErrorResponse" }, "422": { "$ref": "#/components/responses/422" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } }, "patch": { "summary": "Update the profile for a specific WhatsApp Business Account (WABA) Number", "description": "Update details of the profile for a specific Number associated with a WhatsApp Business Account (WABA).", "operationId": "updateWhatsAppWabaNumberProfile", "tags": [ "WhatsApp WABAs" ], "security": [ { "bearerAuth": [] }, { "basicAuth": [] } ], "requestBody": { "$ref": "#/components/requestBodies/WhatsAppUpdateNumberProfileRequest" }, "responses": { "200": { "$ref": "#/components/responses/WhatsAppNumberProfileResponse" }, "400": { "$ref": "#/components/responses/WhatsAppProfileInvalidErrorResponse" }, "401": { "$ref": "#/components/responses/401" }, "404": { "$ref": "#/components/responses/WhatsAppProfileNotFoundErrorResponse" }, "422": { "$ref": "#/components/responses/422" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } } }, "/v1/channel-manager/whatsapp/wabas/{waba_id}/template-analytics": { "parameters": [ { "$ref": "#/components/parameters/WhatsAppWabaId" } ], "get": { "summary": "Get Template Analytics", "description": "Get analytics for a specific template.", "operationId": "getTemplateAnalytics", "tags": [ "WhatsApp Analytics" ], "security": [ { "bearerAuth": [] }, { "basicAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/TemplateIds" }, { "$ref": "#/components/parameters/StartDate" }, { "$ref": "#/components/parameters/EndDate" }, { "$ref": "#/components/parameters/MetricTypes" }, { "$ref": "#/components/parameters/TemplateGranularity" } ], "responses": { "200": { "$ref": "#/components/responses/WhatsAppTemplateAnalyticsResponse" }, "400": { "$ref": "#/components/responses/400" }, "401": { "$ref": "#/components/responses/401" }, "404": { "$ref": "#/components/responses/WhatsAppWabaNotFoundErrorResponse" }, "422": { "$ref": "#/components/responses/422" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } } }, "/v1/channel-manager/whatsapp/wabas/{waba_id}/messaging-analytics": { "parameters": [ { "$ref": "#/components/parameters/WhatsAppWabaId" } ], "get": { "summary": "Get Messaging Analytics", "description": "Get analytics for WhatsApp messages", "operationId": "getMessagingAnalytics", "tags": [ "WhatsApp Analytics" ], "security": [ { "bearerAuth": [] }, { "basicAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/Granularity" }, { "$ref": "#/components/parameters/StartDate" }, { "$ref": "#/components/parameters/EndDate" }, { "$ref": "#/components/parameters/ProductTypes" }, { "$ref": "#/components/parameters/PhoneNumbers" }, { "$ref": "#/components/parameters/CountryCodes" } ], "responses": { "200": { "$ref": "#/components/responses/WhatsAppMessagingAnalyticsResponse" }, "401": { "$ref": "#/components/responses/401" }, "404": { "$ref": "#/components/responses/WhatsAppWabaNotFoundErrorResponse" }, "422": { "$ref": "#/components/responses/422" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } } }, "/v1/channel-manager/whatsapp/wabas/{waba_id}/pricing-analytics": { "parameters": [ { "$ref": "#/components/parameters/WhatsAppWabaId" } ], "get": { "summary": "Get Pricing Analytics", "description": "Get analytics for message pricing.", "operationId": "getPricingAnalytics", "tags": [ "WhatsApp Analytics" ], "security": [ { "bearerAuth": [] }, { "basicAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/StartDate" }, { "$ref": "#/components/parameters/EndDate" }, { "$ref": "#/components/parameters/Granularity" }, { "$ref": "#/components/parameters/PhoneNumbers" }, { "$ref": "#/components/parameters/CountryCodes" }, { "$ref": "#/components/parameters/Dimensions" }, { "$ref": "#/components/parameters/Tier" } ], "responses": { "200": { "$ref": "#/components/responses/WhatsAppPricingAnalyticsResponse" }, "400": { "$ref": "#/components/responses/400" }, "401": { "$ref": "#/components/responses/401" }, "404": { "$ref": "#/components/responses/WhatsAppWabaNotFoundErrorResponse" }, "422": { "$ref": "#/components/responses/422" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } } }, "/v1/channel-manager/whatsapp/tp-registration/url": { "post": { "summary": "Generate Hosted ES Flow URL", "description": "Generate a URL for the start page for WhatsApp hosted embedded sign-up flow based on the supplied partner solution ID.", "operationId": "postWhatsAppTpRegistrationUrl", "tags": [ "WhatsApp Hosted ES Flow" ], "security": [ { "bearerAuth": [] }, { "basicAuth": [] } ], "requestBody": { "$ref": "#/components/requestBodies/WhatsAppHostedFlowRegistrationRequest" }, "responses": { "200": { "$ref": "#/components/responses/WhatsAppFlowResponse" }, "400": { "$ref": "#/components/responses/400" }, "401": { "$ref": "#/components/responses/401" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } } }, "/v1/channel-manager/whatsapp/wabas/{waba_id}/enable_insights": { "parameters": [ { "$ref": "#/components/parameters/WhatsAppWabaId" } ], "patch": { "summary": "Enable template analytics", "description": "Before you can fetch template analytics, Meta guidelines ask you to enable \"insights\". This endpoint will enable insights", "operationId": "enableTemplateAnalytics", "tags": [ "WhatsApp Analytics" ], "security": [ { "bearerAuth": [] }, { "basicAuth": [] } ], "responses": { "204": { "$ref": "#/components/responses/204" }, "401": { "$ref": "#/components/responses/401" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } } }, "/v1/channel-manager/rcs/agents/{sender_id}/google/phones/{phone_number}/capabilities": { "get": { "operationId": "getDeviceRCSCapabilitiesDeprecated", "summary": "RCS Capabilities Device Check", "description": "Get RCS Capabilities for a Specific Device.\n**Please note that this operation is deprecated, please refer to [this one](#getDeviceRCSCapabilities) instead.**\n", "tags": [ "RCS Capability Checks" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "$ref": "#/components/responses/RCSCapabilityResponse" }, "400": { "$ref": "#/components/responses/400" }, "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "404": { "$ref": "#/components/responses/404" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } }, "deprecated": true }, "parameters": [ { "$ref": "#/components/parameters/SenderId" }, { "$ref": "#/components/parameters/PhoneNumber" } ] }, "/v1/channel-manager/rcs/agents/{sender_id}/devices/capabilities": { "post": { "operationId": "getDeviceRCSCapabilities", "summary": "RCS Capabilities Device Check", "description": "Get RCS Capabilities for a Specific Device", "tags": [ "RCS Capability Checks" ], "security": [ { "basicAuth": [] }, { "bearerAuth": [] } ], "requestBody": { "$ref": "#/components/requestBodies/RCSDeviceCapabilityRequest" }, "responses": { "200": { "$ref": "#/components/responses/RCSDeviceCapabilityResponse" }, "400": { "$ref": "#/components/responses/400" }, "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "404": { "$ref": "#/components/responses/404" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } }, "parameters": [ { "$ref": "#/components/parameters/SenderId" } ] }, "/v1/channel-manager/rcs/agents/{sender_id}/google/{operation}": { "post": { "operationId": "postRCSCapabilitiesBulkCheck", "summary": "RCS Capabilities Bulk Check", "description": "Perform an RCS Capability Check for Multiple Devices. See the [RCS Capability Checks](/messages/guides/rcs/rcs-device-capability-check) documentation for more information.", "tags": [ "RCS Capability Checks" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "$ref": "#/components/requestBodies/RCSCapabilityBulkCheckRequest" }, "responses": { "200": { "$ref": "#/components/responses/RCSBulkCapabilityCheckResponse" }, "400": { "$ref": "#/components/responses/400" }, "401": { "$ref": "#/components/responses/401" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } }, "parameters": [ { "$ref": "#/components/parameters/SenderId" }, { "$ref": "#/components/parameters/Operation" } ] }, "/v1/channel-manager/rcs/opt-out/{sender_id}": { "get": { "operationId": "getRCSOptOutInfo", "summary": "Get Opt-out Information", "description": "Retrieve RCS Opt-out information. Note: this feature is only available to accounts with RCS enabled; please contact your Vonage representative for more information.", "tags": [ "RCS Opt-out Management" ], "security": [ { "basicAuth": [] } ], "responses": { "200": { "$ref": "#/components/responses/RCSOptOutInfoResponse" }, "401": { "$ref": "#/components/responses/401" }, "404": { "$ref": "#/components/responses/404" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } }, "post": { "operationId": "updateRCSOptOutInfo", "summary": "Update Opt-out Information", "description": "Update RCS Opt-out information. Note: this feature is only available to accounts with RCS enabled; please contact your Vonage representative for more information.", "tags": [ "RCS Opt-out Management" ], "security": [ { "basicAuth": [] } ], "requestBody": { "$ref": "#/components/requestBodies/RCSOptOutUpdateRequest" }, "responses": { "200": { "$ref": "#/components/responses/RCSOptOutInfoResponse" }, "400": { "$ref": "#/components/responses/RCSOptOutErrorResponse" }, "401": { "$ref": "#/components/responses/401" }, "404": { "$ref": "#/components/responses/404" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } }, "parameters": [ { "$ref": "#/components/parameters/SenderId" } ] }, "/v1/channel-manager/rcs/brands": { "get": { "operationId": "listRCSBrandsDeprecated", "summary": "List Brands (Deprecated)", "description": "Retrieve a list of RCS Brands. Deprecated, please use the [v2 endpoint](#listRCSBrands) instead.", "tags": [ "RCS Brand Management" ], "security": [ { "basicAuth": [] } ], "responses": { "200": { "$ref": "#/components/responses/RCSListBrandsResponseV1" }, "401": { "$ref": "#/components/responses/401" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } }, "deprecated": true }, "post": { "operationId": "createRCSBrandDeprecated", "summary": "Create Brand (Deprecated)", "description": "Create a new RCS Brand. Deprecated, please use the [v2 endpoint](#createRCSBrand) instead.", "tags": [ "RCS Brand Management" ], "security": [ { "basicAuth": [] } ], "requestBody": { "$ref": "#/components/requestBodies/RCSBrandRequestV1" }, "responses": { "200": { "$ref": "#/components/responses/RCSCreateBrandResponseV1" }, "400": { "$ref": "#/components/responses/400" }, "401": { "$ref": "#/components/responses/401" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } }, "deprecated": true } }, "/v1/channel-manager/rcs/brands/{brand_id}": { "patch": { "operationId": "updateRCSBrandDeprecated", "summary": "Update Brand (Deprecated)", "description": "Update an existing RCS Brand. Deprecated, please use the [v2 endpoint](#updateRCSBrand) instead.", "tags": [ "RCS Brand Management" ], "security": [ { "basicAuth": [] } ], "requestBody": { "$ref": "#/components/requestBodies/RCSBrandRequestV1" }, "responses": { "200": { "$ref": "#/components/responses/RCSUpdateBrandResponseV1" }, "400": { "$ref": "#/components/responses/400" }, "401": { "$ref": "#/components/responses/401" }, "404": { "$ref": "#/components/responses/404" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } }, "deprecated": true }, "delete": { "operationId": "deleteRCSBrandDeprecated", "summary": "Delete Brand (Deprecated)", "description": "Delete an existing RCS Brand. Deprecated, please use the [v2 endpoint](#deleteRCSBrand) instead.", "tags": [ "RCS Brand Management" ], "security": [ { "basicAuth": [] } ], "responses": { "204": { "$ref": "#/components/responses/204" }, "401": { "$ref": "#/components/responses/401" }, "404": { "$ref": "#/components/responses/404" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } }, "deprecated": true }, "parameters": [ { "$ref": "#/components/parameters/BrandId" } ] }, "/v2/channel-manager/rcs/brands": { "get": { "operationId": "listRCSBrands", "summary": "List Brands", "description": "Retrieve a list of RCS Brands.", "tags": [ "RCS Brand Management" ], "security": [ { "basicAuth": [] } ], "responses": { "200": { "$ref": "#/components/responses/RCSListBrandsResponseV2" }, "400": { "$ref": "#/components/responses/400" }, "401": { "$ref": "#/components/responses/401" }, "404": { "$ref": "#/components/responses/404" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } }, "post": { "operationId": "createRCSBrand", "summary": "Create Brand", "description": "Create a new RCS Brand.", "tags": [ "RCS Brand Management" ], "security": [ { "basicAuth": [] } ], "requestBody": { "$ref": "#/components/requestBodies/RCSCreateBrandRequestV2" }, "responses": { "200": { "$ref": "#/components/responses/RCSCreateBrandResponseV2" }, "400": { "$ref": "#/components/responses/400" }, "401": { "$ref": "#/components/responses/401" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } } }, "/v2/channel-manager/rcs/brands/{brand_id}": { "patch": { "operationId": "updateRCSBrand", "summary": "Update Brand", "description": "Update an existing RCS Brand.", "tags": [ "RCS Brand Management" ], "security": [ { "basicAuth": [] } ], "requestBody": { "$ref": "#/components/requestBodies/RCSUpdateBrandRequestV2" }, "responses": { "200": { "$ref": "#/components/responses/RCSUpdateBrandResponseV2" }, "400": { "$ref": "#/components/responses/400" }, "401": { "$ref": "#/components/responses/401" }, "404": { "$ref": "#/components/responses/404" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } }, "delete": { "operationId": "deleteRCSBrand", "summary": "Delete Brand", "description": "Delete an existing RCS Brand.", "tags": [ "RCS Brand Management" ], "security": [ { "basicAuth": [] } ], "responses": { "204": { "$ref": "#/components/responses/204" }, "401": { "$ref": "#/components/responses/401" }, "404": { "$ref": "#/components/responses/404" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } }, "parameters": [ { "$ref": "#/components/parameters/BrandId" } ] }, "/v1/channel-manager/rcs/agents": { "get": { "operationId": "listRCSAgentsDeprecated", "summary": "List Agents (Deprecated)", "description": "Retrieve a list of RCS Agents. Deprecated, please use the [v2 endpoint](#listRCSAgents) instead.", "tags": [ "RCS Agent Management" ], "security": [ { "basicAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/RCSBrandIdFilterV2" }, { "$ref": "#/components/parameters/StateFilterv1" }, { "$ref": "#/components/parameters/AgentPurposeFilterv1" }, { "$ref": "#/components/parameters/BillingCategoryFilterv1" }, { "$ref": "#/components/parameters/HostingRegionFilterv1" }, { "$ref": "#/components/parameters/PageNumber" }, { "$ref": "#/components/parameters/PageSize" }, { "$ref": "#/components/parameters/Order_1" } ], "responses": { "200": { "$ref": "#/components/responses/RCSListAgentsResponsev1" }, "401": { "$ref": "#/components/responses/401" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } }, "deprecated": true }, "post": { "operationId": "createRCSAgentDeprecated", "summary": "Create Agent (Deprecated)", "description": "Create a new RCS Agent. Deprecated, please use the [v2 endpoint](#createRCSAgent) instead.", "tags": [ "RCS Agent Management" ], "security": [ { "basicAuth": [] } ], "requestBody": { "$ref": "#/components/requestBodies/RCSAgentRequestv1" }, "responses": { "201": { "$ref": "#/components/responses/RCSCreateAgentResponsev1" }, "400": { "$ref": "#/components/responses/400" }, "401": { "$ref": "#/components/responses/401" }, "404": { "$ref": "#/components/responses/404" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } }, "deprecated": true } }, "/v1/channel-manager/rcs/agents/{agent_id}": { "get": { "operationId": "getRCSAgentDeprecated", "summary": "Get Agent (Deprecated)", "description": "Retrieve an existing RCS Agent. Deprecated, please use the [v2 endpoint](#getRCSAgent) instead.", "tags": [ "RCS Agent Management" ], "security": [ { "basicAuth": [] } ], "responses": { "200": { "$ref": "#/components/responses/RCSAgentResponsev1" }, "401": { "$ref": "#/components/responses/401" }, "404": { "$ref": "#/components/responses/404" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } }, "deprecated": true }, "put": { "operationId": "updateRCSAgentDeprecated", "summary": "Update Agent (Deprecated)", "description": "Fully update an existing RCS Agent. Deprecated, please use the [v2 endpoint](#updateRCSAgent) instead.", "tags": [ "RCS Agent Management" ], "security": [ { "basicAuth": [] } ], "requestBody": { "$ref": "#/components/requestBodies/RCSAgentRequestv1" }, "responses": { "202": { "$ref": "#/components/responses/RCSAgentResponsev1" }, "400": { "$ref": "#/components/responses/400" }, "401": { "$ref": "#/components/responses/401" }, "404": { "$ref": "#/components/responses/404" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } }, "deprecated": true }, "patch": { "operationId": "patchRCSAgentDeprecated", "summary": "Partially Update Agent (Deprecated)", "description": "Partially update an existing RCS Agent. Deprecated, please use the [v2 endpoint](#patchRCSAgent) instead.", "tags": [ "RCS Agent Management" ], "security": [ { "basicAuth": [] } ], "requestBody": { "$ref": "#/components/requestBodies/RCSAgentRequestv1" }, "responses": { "202": { "$ref": "#/components/responses/RCSAgentResponsev1" }, "400": { "$ref": "#/components/responses/400" }, "401": { "$ref": "#/components/responses/401" }, "404": { "$ref": "#/components/responses/404" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } }, "deprecated": true }, "parameters": [ { "$ref": "#/components/parameters/AgentIdv1" } ] }, "/v1/channel-manager/rcs/metadata/carriers": { "get": { "operationId": "getRCSCarriersDeprecated", "summary": "Get Carriers (Deprecated)", "description": "Retrieve a list of available carriers for RCS. Deprecated, please use the [v2 endpoint](#getRCSCarriers) instead.", "tags": [ "RCS Agent Management" ], "security": [ { "basicAuth": [] } ], "responses": { "200": { "$ref": "#/components/responses/RCSCarrierResponsev1" }, "401": { "$ref": "#/components/responses/401" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } }, "deprecated": true } }, "/v1/channel-manager/rcs/agents/{agent_id}/carriers": { "post": { "operationId": "addCarriersToRCSAgentDeprecated", "summary": "Add Carriers to Agent (Deprecated)", "description": "Add carriers to an existing RCS Agent. Deprecated, please use the [v2 endpoint](#addCarriersToRCSAgent) instead.", "tags": [ "RCS Agent Management" ], "security": [ { "basicAuth": [] } ], "requestBody": { "$ref": "#/components/requestBodies/RCSAddCarriersToAgentRequestv1" }, "responses": { "202": { "$ref": "#/components/responses/RCSCarrierUpdateResponsev1" }, "400": { "$ref": "#/components/responses/400" }, "401": { "$ref": "#/components/responses/401" }, "404": { "$ref": "#/components/responses/404" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } }, "deprecated": true }, "parameters": [ { "$ref": "#/components/parameters/AgentIdv1" } ] }, "/v1/channel-manager/rcs/agents/{agent_id}/test-devices": { "post": { "operationId": "addTestDevicesToRCSAgentDeprecated", "summary": "Add Test Devices to Agent (Deprecated)", "description": "Add test devices to an existing RCS Agent. Deprecated, please use the [v2 endpoint](#addTestDevicesToRCSAgent) instead.", "tags": [ "RCS Agent Management" ], "security": [ { "basicAuth": [] } ], "requestBody": { "$ref": "#/components/requestBodies/RCSAddTestDevicesToAgentRequestv1" }, "responses": { "202": { "$ref": "#/components/responses/RCSTestDeviceResponsev1" }, "400": { "$ref": "#/components/responses/400" }, "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "404": { "$ref": "#/components/responses/404" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } }, "deprecated": true }, "parameters": [ { "$ref": "#/components/parameters/AgentIdv1" } ] }, "/v1/channel-manager/rcs/agents/{agent_id}/test-devices/{test_device_id}": { "delete": { "operationId": "removeTestDeviceFromRCSAgentDeprecated", "summary": "Remove Test Device from Agent (Deprecated)", "description": "Remove a test device from an existing RCS Agent. Deprecated, please use the [v2 endpoint](#removeTestDeviceFromRCSAgent) instead.", "tags": [ "RCS Agent Management" ], "security": [ { "basicAuth": [] } ], "responses": { "204": { "$ref": "#/components/responses/204" }, "401": { "$ref": "#/components/responses/401" }, "404": { "$ref": "#/components/responses/404" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } }, "deprecated": true }, "parameters": [ { "$ref": "#/components/parameters/AgentIdv1" }, { "$ref": "#/components/parameters/TestDeviceIdv1" } ] }, "/v2/channel-manager/rcs/agents": { "get": { "operationId": "listRCSAgents", "summary": "List Agents", "description": "Retrieve a list of RCS Agents.", "tags": [ "RCS Agent Management" ], "security": [ { "basicAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/RCSBrandIdFilterV2" }, { "$ref": "#/components/parameters/RCSAgentStateFilterV2" }, { "$ref": "#/components/parameters/RCSAgentPurposeFilterV2" }, { "$ref": "#/components/parameters/RCSBillingCategoryFilterV2" }, { "$ref": "#/components/parameters/RCSHostingRegionFilterV2" }, { "$ref": "#/components/parameters/PageNumber" }, { "$ref": "#/components/parameters/PageSize" }, { "$ref": "#/components/parameters/Order_1" } ], "responses": { "200": { "$ref": "#/components/responses/RCSListAgentsResponseV2" }, "401": { "$ref": "#/components/responses/401" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } }, "post": { "operationId": "createRCSAgent", "summary": "Create Agent", "description": "Create a new RCS Agent.", "tags": [ "RCS Agent Management" ], "security": [ { "basicAuth": [] } ], "requestBody": { "$ref": "#/components/requestBodies/RCSCreateAgentRequestV2" }, "responses": { "201": { "$ref": "#/components/responses/RCSCreateAgentResponseV2" }, "400": { "$ref": "#/components/responses/400" }, "401": { "$ref": "#/components/responses/401" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } } }, "/v2/channel-manager/rcs/agents/{agent_id}": { "get": { "operationId": "getRCSAgent", "summary": "Get Agent", "description": "Retrieve an existing RCS Agent.", "tags": [ "RCS Agent Management" ], "security": [ { "basicAuth": [] } ], "responses": { "200": { "$ref": "#/components/responses/RCSGetAgentResponseV2" }, "401": { "$ref": "#/components/responses/401" }, "404": { "$ref": "#/components/responses/404" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } }, "put": { "operationId": "updateRCSAgent", "summary": "Update Agent", "description": "Fully update an existing RCS Agent.", "tags": [ "RCS Agent Management" ], "security": [ { "basicAuth": [] } ], "requestBody": { "$ref": "#/components/requestBodies/RCSUpdateAgentRequestV2" }, "responses": { "202": { "$ref": "#/components/responses/RCSUpdateAgentResponseV2" }, "400": { "$ref": "#/components/responses/400" }, "401": { "$ref": "#/components/responses/401" }, "404": { "$ref": "#/components/responses/404" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } }, "patch": { "operationId": "patchRCSAgent", "summary": "Partially Update Agent", "description": "Partially update an existing RCS Agent.", "tags": [ "RCS Agent Management" ], "security": [ { "basicAuth": [] } ], "requestBody": { "$ref": "#/components/requestBodies/RCSPartiallyUpdateAgentRequestV2" }, "responses": { "202": { "$ref": "#/components/responses/RCSPartiallyUpdateAgentResponseV2" }, "400": { "$ref": "#/components/responses/400" }, "401": { "$ref": "#/components/responses/401" }, "404": { "$ref": "#/components/responses/404" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } }, "parameters": [ { "$ref": "#/components/parameters/RCSAgentIdV2" } ] }, "/v2/channel-manager/rcs/metadata/carriers": { "get": { "operationId": "getRCSCarriers", "summary": "Get Carriers", "description": "Retrieve a list of available carriers for RCS.", "tags": [ "RCS Agent Management" ], "security": [ { "basicAuth": [] } ], "responses": { "200": { "$ref": "#/components/responses/RCSGetCarriersResponseV2" }, "401": { "$ref": "#/components/responses/401" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } } }, "/v2/channel-manager/rcs/agents/{agent_id}/carriers": { "post": { "operationId": "addCarriersToRCSAgent", "summary": "Add Carriers to Agent", "description": "Add carriers to an existing RCS Agent.", "tags": [ "RCS Agent Management" ], "security": [ { "basicAuth": [] } ], "requestBody": { "$ref": "#/components/requestBodies/RCSAddCarriersToAgentRequestV2" }, "responses": { "202": { "$ref": "#/components/responses/RCSCarrierUpdateResponseV2" }, "400": { "$ref": "#/components/responses/400" }, "401": { "$ref": "#/components/responses/401" }, "404": { "$ref": "#/components/responses/404" }, "409": { "$ref": "#/components/responses/409" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } }, "parameters": [ { "$ref": "#/components/parameters/RCSAgentIdV2" } ] }, "/v2/channel-manager/rcs/agents/{agent_id}/launch": { "post": { "operationId": "launchRCSAgent", "summary": "Launch RCS Agent", "description": "Launch an existing RCS Agent", "tags": [ "RCS Agent Management" ], "security": [ { "basicAuth": [] } ], "responses": { "202": { "$ref": "#/components/responses/RCSLaunchCarrierResponseV2" }, "401": { "$ref": "#/components/responses/401" }, "404": { "$ref": "#/components/responses/404" }, "422": { "$ref": "#/components/responses/RCSDeeplinkCountryNotSupportedErrorResponse" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } }, "parameters": [ { "$ref": "#/components/parameters/RCSAgentIdV2" } ] } }, "/v2/channel-manager/rcs/agents/{agent_id}/test-devices": { "post": { "operationId": "addTestDevicesToRCSAgent", "summary": "Add Test Devices to Agent", "description": "Add test devices to an existing RCS Agent.", "tags": [ "RCS Agent Management" ], "security": [ { "basicAuth": [] } ], "requestBody": { "$ref": "#/components/requestBodies/RCSAddTestDevicesToAgentRequestV2" }, "responses": { "202": { "$ref": "#/components/responses/RCSAddTestDevicesToAgentResponseV2" }, "400": { "$ref": "#/components/responses/400" }, "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "404": { "$ref": "#/components/responses/404" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } }, "parameters": [ { "$ref": "#/components/parameters/RCSAgentIdV2" } ] }, "/v2/channel-manager/rcs/agents/{agent_id}/test-devices/{test_device_id}": { "delete": { "operationId": "removeTestDeviceFromRCSAgent", "summary": "Remove Test Device from Agent", "description": "Remove a test device from an existing RCS Agent.", "tags": [ "RCS Agent Management" ], "security": [ { "basicAuth": [] } ], "responses": { "204": { "$ref": "#/components/responses/204" }, "401": { "$ref": "#/components/responses/401" }, "404": { "$ref": "#/components/responses/404" }, "429": { "$ref": "#/components/responses/429" }, "500": { "$ref": "#/components/responses/500" } } }, "parameters": [ { "$ref": "#/components/parameters/RCSAgentIdV2" }, { "$ref": "#/components/parameters/RCSTestDeviceIdV2" } ] }, "/v1/channel-manager/rcs/deeplink/generate": { "post": { "operationId": "generateRCSDeeplink", "summary": "Generate RCS Deeplink", "description": "Generate an RCS deeplink for a specific RCS agent and use case. See the [RCS Deeplinks](https://developer.vonage.com/channel-manager/concepts/rcs-deeplinks) documentation for more information.", "tags": [ "RCS Deeplinks" ], "security": [ { "basicAuth": [] } ], "requestBody": { "$ref": "#/components/requestBodies/RCSDeeplinkRequest" }, "responses": { "200": { "$ref": "#/components/responses/RCSDeeplinkResponse" }, "400": { "$ref": "#/components/responses/400" }, "401": { "$ref": "#/components/responses/401" }, "404": { "$ref": "#/components/responses/RCSDeeplinkSenderNotFoundErrorResponse" }, "422": { "$ref": "#/components/responses/RCSDeeplinkCountryNotSupportedErrorResponse" }, "500": { "$ref": "#/components/responses/500" } } } } }, "components": { "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "JWT" }, "basicAuth": { "type": "http", "scheme": "basic" } }, "parameters": { "TemplateIds": { "name": "template_ids", "in": "query", "description": "An array of the `template_ids` of the WhatsApp template(s).", "required": true, "schema": { "type": "array", "minItems": 1, "maxItems": 10, "items": { "$ref": "#/components/schemas/WhatsAppTemplateId" } } }, "TemplateId": { "name": "template_id", "in": "path", "description": "The WhatsApp template Id", "required": true, "schema": { "$ref": "#/components/schemas/WhatsAppTemplateId" } }, "StartDate": { "name": "start", "in": "query", "description": "The start date and time in ISO-8601 format for the analytics data to be retrieved from, in the format `YYYY-MM-DD`.", "required": true, "schema": { "type": "string", "format": "timestamp", "example": "2024-11-01" } }, "EndDate": { "name": "end", "in": "query", "description": "The end date and time in ISO-8601 format for the analytics data to be retrieved to, in the format `YYYY-MM-DD`. The maximum difference between the `start` and `end` dates is 90 days.\n", "required": true, "schema": { "type": "string", "format": "timestamp", "example": "2024-11-03" } }, "MetricTypes": { "name": "metric_types", "in": "query", "description": "An array of the metric types to retrieve analytics for. Possible values are `SENT`, `DELIVERED`, `READ`, and `CLICKED`.", "required": false, "schema": { "type": "array", "items": { "type": "string", "enum": [ "SENT", "DELIVERED", "READ", "CLICKED" ] }, "example": [ "SENT", "DELIVERED" ] } }, "TemplateGranularity": { "name": "granularity", "in": "query", "description": "The granularity at which you would like to retrieve the template analytics.", "required": true, "schema": { "$ref": "#/components/schemas/TemplateGranularity" } }, "Granularity": { "name": "granularity", "in": "query", "description": "The granularity at which you would like to retrieve the analytics.", "required": true, "schema": { "$ref": "#/components/schemas/Granularity" } }, "ProductTypes": { "name": "product_types", "in": "query", "description": "An array of the message types to retrieve analytics for. Possible values are `0` for notification messages and/or 2 for customer support messages. If not specified, analytics for all message types will be returned.", "required": false, "schema": { "type": "array", "items": { "type": "integer", "enum": [ 0, 2 ] }, "example": [ 0 ] } }, "PhoneNumbers": { "name": "phone_numbers", "in": "query", "description": "Phone numbers for which you would like to retrieve analytics. If not specified, analytics for all phone numbers associated with the WABA will be returned.", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "example": [ "16505550111" ] } }, "CountryCodes": { "name": "country_codes", "in": "query", "description": "Two-letter country codes for the countries for which you would like to retrieve analytics. If not specified, analytics for all countries will be returned.", "required": false, "schema": { "type": "array", "items": { "$ref": "#/components/schemas/WhatsAppCountryCode" }, "example": [ "US" ] } }, "Dimensions": { "name": "dimensions", "in": "query", "description": "List of breakdowns you would like to apply to your metrics. If empty, all results returned without any breakdowns.", "required": false, "schema": { "type": "array", "items": { "type": "string", "enum": [ "PRICING_CATEGORY", "PRICING_TYPE", "COUNTRY", "PHONE", "TIER" ] }, "example": [ "PRICING_CATEGORY" ] } }, "Tier": { "name": "tier", "in": "query", "description": "The tier property value represents a concatenation of the lower and upper bounds for the tier specific to the market–category pair (country and pricing_category).", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "example": [ "0:100000" ] } }, "Order": { "name": "order", "in": "query", "description": "The order.", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] }, "example": "asc" }, "SubscriptionId": { "name": "subscription_id", "in": "path", "description": "The ID of the notification subscription to delete.", "required": true, "schema": { "type": "string", "example": "9fa85698-c92a-4786-be0e-b5a489425120" } }, "WhatsAppWabaId": { "name": "waba_id", "in": "path", "description": "The `waba_id` of the WhatsApp Business Account (WABA).", "required": true, "schema": { "$ref": "#/components/schemas/WhatsAppWabaId" } }, "WhatsAppNumber": { "name": "whatsapp_number", "in": "path", "description": "The WhatsApp number.", "required": true, "schema": { "$ref": "#/components/schemas/WhatsAppWabaNumber/properties/phone_number" } }, "Order_1": { "name": "order", "in": "query", "description": "The order.", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ] }, "example": "asc" }, "BrandFilterv1": { "name": "brand_id", "in": "query", "description": "The `id` of an RCS Brand to filter by.", "schema": { "type": "string", "example": "78d335fa-323d-0114-9c3d-d6f0d48968cf" } }, "RCSBrandIdFilterV2": { "name": "brand_id", "in": "query", "description": "The `id` of an RCS Brand to filter by.", "schema": { "type": "string", "format": "uuid", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$", "example": "0198ecd4-da21-7f8b-91d8-ccfbaec485a7" } }, "StateFilterv1": { "name": "state", "in": "query", "description": "The `state` of the RCS Agent to filter by.", "schema": { "type": "string", "enum": [ "DRAFT", "CREATED", "VERIFIED", "LAUNCHED", "REJECTED", "UNLAUNCHED" ], "example": "DRAFT" } }, "RCSAgentStateFilterV2": { "name": "state", "in": "query", "description": "The `state` of the RCS Agent to filter by. Can be specified multiple times for multiple values.", "schema": { "type": "string", "enum": [ "DRAFT", "CREATED", "PENDING", "LAUNCHED", "REJECTED", "UNLAUNCHED" ], "example": "DRAFT" } }, "AgentPurposeFilterv1": { "name": "agent_purpose", "in": "query", "description": "The `agent_purpose` of the RCS Agent to filter by.", "schema": { "$ref": "#/components/schemas/RCSAgentPurposev1" } }, "RCSAgentPurposeFilterV2": { "name": "agent_purpose", "in": "query", "description": "The `agent_purpose` of the RCS Agent to filter by. Can be specified multiple times.", "schema": { "$ref": "#/components/schemas/RCSAgentPurposeV2" } }, "BillingCategoryFilterv1": { "name": "billing_category", "in": "query", "description": "The `billing_category` of the RCS Agent to filter by.", "schema": { "$ref": "#/components/schemas/RCSBillingCategoryv1" } }, "RCSBillingCategoryFilterV2": { "name": "billing_category", "in": "query", "description": "The `billing_category` of the RCS Agent to filter by. Can be specified multiple times.", "schema": { "$ref": "#/components/schemas/RCSBillingCategoryV2" } }, "HostingRegionFilterv1": { "name": "hosting_region", "in": "query", "description": "The `hosting_region` of the RCS Agent to filter by.", "schema": { "$ref": "#/components/schemas/RCSHostingRegionv1" } }, "RCSHostingRegionFilterV2": { "name": "hosting_region", "in": "query", "description": "The `hosting_region` of the RCS Agent to filter by. Can be specified multiple times.", "schema": { "$ref": "#/components/schemas/RCSHostingRegionV2" } }, "SenderId": { "name": "sender_id", "in": "path", "description": "The Sender ID of your RCS Agent.", "required": true, "schema": { "type": "string", "example": "VonageAgent" } }, "PhoneNumber": { "name": "phone_number", "in": "path", "description": "The phone number of the device to check.", "required": true, "schema": { "$ref": "#/components/schemas/PhoneNumber" } }, "Operation": { "name": "operation", "in": "path", "description": "The operation to perform.", "required": true, "schema": { "type": "string", "enum": [ "users:batchGet" ] }, "example": "users:batchGet" }, "BrandId": { "name": "brand_id", "in": "path", "description": "The Id of the Brand.", "required": true, "schema": { "type": "string", "example": "78d335fa-323d-0114-9c3d-d6f0d48968cf" } }, "AgentIdv1": { "name": "agent_id", "in": "path", "description": "Agent ID", "required": true, "schema": { "type": "string", "example": "78d335fa-323d-0114-9c3d-d6f0d48968cf" } }, "RCSAgentIdV2": { "name": "agent_id", "in": "path", "description": "Agent ID", "required": true, "schema": { "type": "string", "example": "78d335fa-323d-0114-9c3d-d6f0d48968cf" } }, "TestDeviceIdv1": { "name": "test_device_id", "in": "path", "description": "Test Device Id", "required": true, "schema": { "type": "string", "example": "019809ba-a274-7bd2-aea0-f1f70f2210dc" } }, "RCSTestDeviceIdV2": { "name": "test_device_id", "in": "path", "description": "Test Device Id", "required": true, "schema": { "type": "string", "example": "019809ba-a274-7bd2-aea0-f1f70f2210dc" } }, "PageNumber": { "name": "page", "in": "query", "description": "Page number to retrieve", "required": false, "schema": { "$ref": "#/components/schemas/PageNumber" } }, "PageSize": { "name": "page_size", "in": "query", "description": "Number of items to return per page", "required": false, "schema": { "$ref": "#/components/schemas/PageSize" } } }, "responses": { "204": { "description": "No Content - Resource successfully deleted", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } } }, "400": { "description": "Bad Request", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorResponseWithInvalidParameters" } } } }, "401": { "description": "Authentication failure", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/problem+json": { "schema": { "oneOf": [ { "description": "Missing or Invalid Credentials", "type": "object", "required": [ "type", "title", "instance" ], "properties": { "type": { "type": "string", "description": "Link to error / remediation options", "example": "https://developer.vonage.com/api-errors/#unathorized" }, "title": { "type": "string", "description": "Generic error message", "example": "You did not provide correct credentials." }, "detail": { "type": "string", "description": "Additional information about the error", "example": "Check that you're using the correct credentials, and that your account has this feature enabled" }, "instance": { "type": "string", "description": "Internal Trace ID", "example": "bf0ca0bf927b3b52e3cb03217e1a1ddf" } } }, { "description": "Invalid Application Type", "type": "object", "required": [ "type", "title", "instance" ], "properties": { "type": { "type": "string", "description": "Link to error / remediation options", "example": "https://developer.vonage.com/api-errors/#unprovisioned" }, "title": { "type": "string", "description": "Generic error message", "example": "The crendentials provided do not have access to the requested product" }, "detail": { "type": "string", "description": "Additional information about the error", "example": "Check your API key is correct and has been whitelisted" }, "instance": { "type": "string", "description": "Internal Trace ID", "example": "bf0ca0bf927b3b52e3cb03217e1a1ddf" } } } ] } } } }, "403": { "description": "Forbidden", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Not Found", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Conflict", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Unprocessable Entity", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorResponseWithInvalidParameters" } } } }, "429": { "description": "Too Many Requests", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal error", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "WhatsAppSubscriptionResponse": { "description": "OK", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/json": { "schema": { "type": "array", "description": "An array of of objects, each representing a notification subscription", "items": { "anyOf": [ { "$ref": "#/components/schemas/WhatsAppSubscriptionSlack" }, { "$ref": "#/components/schemas/WhatsAppSubscriptionWebhook" } ] } } } } }, "WhatsAppSubscriptionSingleResponse": { "description": "OK", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/WhatsAppSubscriptionSlack" }, { "$ref": "#/components/schemas/WhatsAppSubscriptionWebhook" } ] } } } }, "WhatsAppTemplateAnalyticsResponse": { "description": "OK", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "granularity": { "$ref": "#/components/schemas/TemplateGranularity" }, "product_type": { "type": "string", "description": "The product type for which the template analytics were retrieved.", "enum": [ "CLOUD_API", "MARKETING_MESSAGES_API_FOR_WHATSAPP" ], "example": "CLOUD_API" }, "page_size": { "type": "integer", "description": "The maximum number of template analytics returned per page.", "example": 100 }, "_embedded": { "type": "object", "properties": { "template_analytics": { "type": "array", "items": { "$ref": "#/components/schemas/WhatsAppTemplateAnalyticsData" } } } }, "_links": { "type": "object", "properties": { "self": { "type": "object", "properties": { "href": { "type": "string", "description": "The URL to the current page of WhatsApp Template Analytics.", "example": "https://api.nexmo.com/v1/channel-manager/whatsapp/wabas/345688589250625/template-analytics?template_ids=[458951126288937]&start=2024-11-10&end=2024-11-14&page_size=100&cursor=c2VsZj1udWxs" } } } } } } } } } }, "WhatsAppMessagingAnalyticsResponse": { "description": "OK", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/WhatsAppWabaId" }, "granularity": { "$ref": "#/components/schemas/Granularity" }, "phone_numbers": { "type": "array", "items": { "type": "string" }, "example": [ "16505550111" ], "description": "Phone numbers for which the messaging analytics were retrieved." }, "country_codes": { "type": "array", "items": { "$ref": "#/components/schemas/WhatsAppCountryCode" } }, "_embedded": { "type": "object", "properties": { "messaging_analytics": { "type": "array", "items": { "$ref": "#/components/schemas/WhatsAppMessagingAnalyticsData" } } } }, "paging": { "type": "object", "properties": { "cursors": { "type": "object", "properties": { "before": { "type": "string", "example": "MAZDZD", "description": "The page before the first page in the current list" }, "after": { "type": "string", "example": "MjQZD", "description": "The page after the last page in the current list" } } }, "next": { "type": "string", "format": "uri", "example": "https://api.nexmo.com/v2/channel-manager/wabas/106499765517625/messaging-analytics?after=MAZDZD", "description": "A URI to ge the next paginated page." }, "previous": { "type": "string", "format": "uri", "example": "https://api.nexmo.com/v2/channel-manager/wabas/106499765517625/messaging-analytics?before=MjQZD", "description": "A URI to ge the previous paginated page." } } } } } } } }, "WhatsAppPricingAnalyticsResponse": { "description": "OK", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "granularity": { "$ref": "#/components/schemas/Granularity" }, "product_type": { "type": "string", "description": "The product type for which the pricing analytics were retrieved.", "enum": [ "FREE_CUSTOMER_SERVICE", "FREE_ENTRY_POINT", "REGULAR" ], "example": "REGULAR" }, "_embedded": { "type": "object", "properties": { "pricing_analytics": { "type": "array", "items": { "$ref": "#/components/schemas/WhatsAppPricingAnalyticsData" } } } }, "paging": { "type": "object", "properties": { "cursors": { "type": "object", "properties": { "before": { "type": "string", "description": "The cursor the previous page of WhatsApp Pricing Analytics.", "example": "MjQZD" }, "after": { "type": "string", "description": "The cursor the next page of WhatsApp Pricing Analytics.", "example": "MAZDZD" } } }, "previous": { "type": "string", "description": "The URL to the previous page of WhatsApp Pricing Analytics.", "example": "https://api.nexmo.com/v1/channel-manager/whatsapp/wabas/345688589250625/pricing-analytics?before=MjQZD" }, "next": { "type": "string", "description": "The URL to the next page of WhatsApp Pricing Analytics.", "example": "https://api.nexmo.com/v1/channel-manager/whatsapp/wabas/345688589250625/pricing-analytics?before=MAZDZD" } } } } } } } }, "WhatsAppWabaListResponse": { "description": "OK", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "page_size": { "$ref": "#/components/schemas/PageSize" }, "page": { "$ref": "#/components/schemas/PageNumber" }, "total_pages": { "$ref": "#/components/schemas/TotalPages" }, "total_items": { "$ref": "#/components/schemas/TotalItems" }, "_embedded": { "type": "object", "properties": { "wabas": { "type": "array", "items": { "$ref": "#/components/schemas/WhatsAppWaba" } } } }, "_links": { "$ref": "#/components/schemas/PaginationLinks" } } } } } }, "WhatsAppWabaResponse": { "description": "OK", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/WhatsAppWaba" }, { "properties": { "_links": { "type": "object", "properties": { "self": { "$ref": "#/components/schemas/SelfLink" }, "numbers": { "$ref": "#/components/schemas/HalLink" } } } } } ] } } } }, "WhatsAppNumbersHalResponse": { "description": "OK", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "page_size": { "$ref": "#/components/schemas/PageSize" }, "page": { "$ref": "#/components/schemas/PageNumber" }, "total_pages": { "$ref": "#/components/schemas/TotalPages" }, "total_items": { "$ref": "#/components/schemas/TotalItems" }, "_embedded": { "type": "object", "properties": { "wabas": { "type": "array", "items": { "$ref": "#/components/schemas/WhatsAppWabaNumber" } } } }, "_links": { "$ref": "#/components/schemas/PaginationLinks" } } } } } }, "WhatsAppNumbersResponse": { "description": "OK", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/WhatsAppWabaNumber" }, { "properties": { "_links": { "type": "object", "properties": { "self": { "$ref": "#/components/schemas/SelfLink" } } } } } ] } } } }, "WhatsAppNumberProfileResponse": { "description": "OK", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/WhatsAppWabaNumberProfileCommon" }, { "properties": { "messaging_product": { "$ref": "#/components/schemas/WhatsAppWabaNumberProfileMessagingProduct" }, "_links": { "type": "object", "properties": { "self": { "$ref": "#/components/schemas/SelfLink" } } } } } ] } } } }, "WhatsAppFlowResponse": { "description": "OK", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "id", "url" ], "properties": { "id": { "type": "string", "description": "The trace ID for the URL generation request.", "example": "3amb0119-0196-42d1-8fb5-55a98s133546" }, "url": { "type": "string", "description": "URL containing tokenized information and redirecting to ES flow start page.", "example": "https://tools.vonage.com/wa/partners/onboard?token=fhdhhdJhbGciOiJSUzI1NiJ9.eyJleHAiOjE3MjU5Njc1OTYsImp0aSI6ImQ1MmJhNmFjLWYxZjktNDdmNC05MTR_cFT1bVfkDhP-wgpKZibSbUoh9z-9KGD-wsmHxi0h7tTidpVhPNShfC5jmgiHtOQKXXv5NWb9OqoUraOMMpqCdNdXoN3ao-PeZX7axyYW_FQ6CeV9gDEPhAZ4urTi0uW4mCYGl3ULmA9Ps92r_wi2DJyRE_Kx2KahWtQd51yVpU6FfXgMb4odREEccDctT1Peo09wKgwBa1wsOkD7rrvkoQPqZ00VXcqOY1_LOO5tq4WJaKqtxX-U7VtDo9qyVUl8pdegZW6QWChQzGN4PkqXXLWcBlyrCtAYdhtWG8q6NM_6bARRjcGJlj0tQvE0PZ9AtafAQSPpOll5lcnUK8Ds" } } } } } }, "WhatsAppCreateSubscriptionErrorResponse": { "description": "Bad Request", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/problem+json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ErrorResponse" }, { "$ref": "#/components/schemas/WhatsAppErrorSubscriptionAlreadyExists" } ] } } } }, "WhatsAppWabaNotFoundErrorResponse": { "description": "Not Found", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/problem+json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/WhatsAppErrorWabaNotFound" } ] } } } }, "WhatsAppWabaNumberNotFoundErrorResponse": { "description": "Not Found", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/problem+json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/WhatsAppErrorWabaNotFound" }, { "$ref": "#/components/schemas/WhatsAppErrorNumberNotFound" } ] } } } }, "WhatsAppProfileNotFoundErrorResponse": { "description": "Not Found", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/problem+json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/WhatsAppErrorNumberNotFound" }, { "$ref": "#/components/schemas/WhatsAppErrorProfileNotFound" } ] } } } }, "WhatsAppProfileInvalidErrorResponse": { "description": "Bad Request", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/problem+json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/WhatsAppErrorInvalidPropertyProfileVertical" }, { "$ref": "#/components/schemas/WhatsAppErrorInvalidPropertyProfileProfilePictureUrlFileError" }, { "$ref": "#/components/schemas/WhatsAppErrorInvalidPropertyProfileProfilePictureUrlLowResolution" }, { "$ref": "#/components/schemas/WhatsAppErrorInvalidPropertyProfileWebsitesInvalidUrls" } ] } } } }, "RCSCapabilityResponse": { "description": "OK", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "features": { "type": "array", "items": { "$ref": "#/components/schemas/RCSFeature" }, "description": "A list of RCS capabilities for the device being checked." } } } } } }, "RCSDeviceCapabilityResponse": { "description": "OK", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "rcs_supported": { "type": "boolean", "description": "Indicates if RCS is supported on the device.", "example": true }, "features": { "type": "array", "items": { "$ref": "#/components/schemas/RCSFeature" }, "description": "A list of RCS capabilities for the device being checked.", "example": [ "RICHCARD_STANDALONE", "RICHCARD_CAROUSEL", "ACTION_CREATE_CALENDAR_EVENT", "ACTION_DIAL", "ACTION_OPEN_URL", "ACTION_SHARE_LOCATION", "ACTION_VIEW_LOCATION" ] } } } } } }, "RCSBulkCapabilityCheckResponse": { "description": "OK", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/json": { "schema": { "type": "object", "oneOf": [ { "$ref": "#/components/schemas/RCSCapabilitiesBulkCheckUsersResponse" }, { "$ref": "#/components/schemas/RCSCapabilitiesBulkCheckSampleResponse" } ], "properties": { "status": { "type": "string", "description": "The status of the operation.", "example": "success" } } } } } }, "RCSOptOutInfoResponse": { "description": "OK", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RCSOptOutInfo" } } } }, "RCSListBrandsResponseV1": { "description": "OK", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": { "brands": { "type": "array", "items": { "$ref": "#/components/schemas/RCSBrandV1" } } }, "required": [ "brands" ] } } } } }, "RCSListBrandsResponseV2": { "description": "OK", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": { "brands": { "type": "array", "items": { "$ref": "#/components/schemas/RCSBrandV2" } } }, "required": [ "brands" ] } } } } }, "RCSCreateBrandResponseV1": { "description": "Created", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/json": { "schema": { "type": "object", "allOf": [ { "$ref": "#/components/schemas/RCSBrandV1" } ] } } } }, "RCSCreateBrandResponseV2": { "description": "OK", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/json": { "schema": { "type": "object", "allOf": [ { "$ref": "#/components/schemas/RCSBrandV2" } ] } } } }, "RCSUpdateBrandResponseV2": { "description": "OK", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/json": { "schema": { "type": "object", "allOf": [ { "$ref": "#/components/schemas/RCSBrandV2" } ] } } } }, "RCSUpdateBrandResponseV1": { "description": "OK", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/json": { "schema": { "type": "object", "allOf": [ { "$ref": "#/components/schemas/RCSBrandV1" } ] } } } }, "RCSListAgentsResponsev1": { "description": "OK", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "page": { "$ref": "#/components/schemas/PageNumber" }, "page_size": { "$ref": "#/components/schemas/PageSize" }, "total_items": { "$ref": "#/components/schemas/TotalItems" }, "total_pages": { "$ref": "#/components/schemas/TotalPages" }, "_embedded": { "type": "object", "properties": { "agents": { "type": "array", "items": { "allOf": [ { "$ref": "#/components/schemas/RCSAgentv1" }, { "$ref": "#/components/schemas/RCSAgentAdditionalPropertiesv1" } ] } } }, "required": [ "agents" ] }, "_links": { "$ref": "#/components/schemas/PaginationLinks" } }, "required": [ "_embedded", "_links", "page", "page_size", "total_items", "total_pages" ] } } } }, "RCSListAgentsResponseV2": { "description": "OK", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "page": { "$ref": "#/components/schemas/PageNumber" }, "page_size": { "$ref": "#/components/schemas/PageSize" }, "total_items": { "$ref": "#/components/schemas/TotalItems" }, "total_pages": { "$ref": "#/components/schemas/TotalPages" }, "_embedded": { "$ref": "#/components/schemas/RCSAgentListV2" }, "_links": { "$ref": "#/components/schemas/PaginationLinks" } }, "required": [ "_embedded", "_links", "page", "page_size", "total_items", "total_pages" ] } } } }, "RCSCreateAgentResponsev1": { "description": "Created", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/json": { "schema": { "type": "object", "allOf": [ { "$ref": "#/components/schemas/RCSAgentv1" } ] } } } }, "RCSCreateAgentResponseV2": { "description": "Created", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/json": { "schema": { "type": "object", "allOf": [ { "$ref": "#/components/schemas/RCSAgentV2" } ] } } } }, "RCSAgentResponsev1": { "description": "OK", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/json": { "schema": { "type": "object", "allOf": [ { "$ref": "#/components/schemas/RCSAgentv1" }, { "$ref": "#/components/schemas/RCSAgentAdditionalPropertiesv1" } ] } } } }, "RCSGetAgentResponseV2": { "description": "OK", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/json": { "schema": { "type": "object", "allOf": [ { "$ref": "#/components/schemas/RCSAgentV2" } ] } } } }, "RCSUpdateAgentResponseV2": { "description": "Accepted", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/json": { "schema": { "type": "object", "allOf": [ { "$ref": "#/components/schemas/RCSAgentV2" } ] } } } }, "RCSPartiallyUpdateAgentResponseV2": { "description": "Accepted", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/json": { "schema": { "type": "object", "allOf": [ { "$ref": "#/components/schemas/RCSAgentV2" } ] } } } }, "RCSCarrierResponsev1": { "description": "OK", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RCSCarrierDatav1" } } } }, "RCSGetCarriersResponseV2": { "description": "OK", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RCSCarrierListV2" } } } }, "RCSCarrierUpdateResponsev1": { "description": "Accepted", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Carriers accepted for processing" } }, "required": [ "message" ] } } } }, "RCSCarrierUpdateResponseV2": { "description": "Accepted", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request accepted for processing" } }, "required": [ "message" ] } } } }, "RCSLaunchCarrierResponseV2": { "description": "Accepted", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Request accepted for processing" } }, "required": [ "message" ] } } } }, "RCSTestDeviceResponsev1": { "description": "Accepted", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/RCSDeviceIdv1" }, "phone": { "$ref": "#/components/schemas/PhoneNumber" }, "created_at": { "type": "string", "description": "The date and time when the test device was created.", "example": "2023-01-01T12:00:00Z" }, "status": { "type": "string", "description": "The current status of the test device.", "example": "ACCEPTED" } }, "required": [ "id", "phone", "created_at", "status" ] } } } }, "RCSAddTestDevicesToAgentResponseV2": { "description": "Accepted", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RCSAgentTestDeviceV2" } } } }, "RCSOptOutErrorResponse": { "description": "Bad Request", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/problem+json": { "schema": { "oneOf": [ { "type": "object", "allOf": [ { "$ref": "#/components/schemas/ErrorResponse" } ], "properties": { "invalid_parameters": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "actions", "actions[].action" ], "description": "The name of the invalid parameter", "example": "actions" }, "reason": { "type": "string", "enum": [ "Missing required START action.", "action must be one of: START, STOP, CUSTOM.", "Missing required STOP action" ], "description": "The reason why the parameter is invalid", "example": "Missing required START action." } }, "required": [ "name", "reason" ] }, "description": "List of invalid parameters" } }, "required": [ "invalid_parameters" ], "description": "Missing Actions" }, { "type": "object", "allOf": [ { "$ref": "#/components/schemas/ErrorResponse" } ], "properties": { "invalid_parameters": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "actions[1].keywords" ], "description": "The name of the invalid parameter", "example": "actions[1].keywords" }, "reason": { "type": "string", "enum": [ "keywords must not be empty." ], "description": "The reason why the parameter is invalid", "example": "keywords must not be empty." } }, "required": [ "name", "reason" ] }, "description": "List of invalid parameters" } }, "required": [ "invalid_parameters" ], "description": "Missing Keywords" } ] } } } }, "RCSDeeplinkResponse": { "description": "OK", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "deep_link": { "type": "string", "format": "uri", "description": "The generated RCS deeplink URL.", "example": "https://tools.vonage.com/rcs/v1/deeplink/jNiLGT29KY4RVzTczcA83NFFhv28Ut-bdnutpcG8OTv-7a8vt75f3ka1eyDh3L4KZTkJ9qgXHk" } }, "required": [ "deep_link" ] } } } }, "RCSDeeplinkSenderNotFoundErrorResponse": { "description": "Not Found", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/problem+json": { "schema": { "type": "object", "description": "Base error response following RFC 7807", "required": [ "type", "title", "instance" ], "properties": { "type": { "type": "string", "description": "Link to error / remediation options", "example": "https://developer.vonage.com/api-errors" }, "title": { "type": "string", "description": "Generic error message", "example": "Sender not found or not owned by the authenticated user" }, "detail": { "type": "string", "description": "Additional information about the error", "example": "More details about what went wrong" }, "instance": { "type": "string", "description": "Internal Trace ID", "example": "bf0ca0bf927b3b52e3cb03217e1a1ddf" } } } } } }, "RCSDeeplinkCountryNotSupportedErrorResponse": { "description": "Unprocessable Content", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/problem+json": { "schema": { "type": "object", "description": "Base error response following RFC 7807", "required": [ "type", "title", "instance" ], "properties": { "type": { "type": "string", "description": "Link to error / remediation options", "example": "https://developer.vonage.com/api-errors" }, "title": { "type": "string", "description": "Generic error message", "example": "Deep Link Not Supported" }, "detail": { "type": "string", "description": "Additional information about the error", "example": "Deep link generation is not supported for country: UK" }, "instance": { "type": "string", "description": "Internal Trace ID", "example": "bf0ca0bf927b3b52e3cb03217e1a1ddf" } } } } } } }, "requestBodies": { "WhatsAppCreateSubscriptionNotificationRequest": { "description": "The request body for the operation.", "required": true, "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/WhatsAppSubscriptionSlack" }, { "$ref": "#/components/schemas/WhatsAppSubscriptionWebhook" } ] } } } }, "WhatsAppUpdateNumberProfileRequest": { "description": "Update a Message.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WhatsAppWabaNumberProfileCommon" } } } }, "WhatsAppHostedFlowRegistrationRequest": { "description": "The request body for the operation.", "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "solution_id" ], "properties": { "solution_id": { "type": "string", "description": "The partner solution ID.", "example": "123456789111213" }, "api_key": { "$ref": "#/components/schemas/VonageApiKey" }, "ttl": { "type": "integer", "description": "The time-to-live for the URL in seconds.", "example": 300, "minimum": 0, "maximum": 259200, "default": 86400 } } } } } }, "RCSDeviceCapabilityRequest": { "description": "The request body for the operation.", "content": { "application/json": { "schema": { "type": "object", "properties": { "msisdn": { "$ref": "#/components/schemas/PhoneNumber" }, "country": { "type": "string", "description": "The country code of the device to check.", "example": "GB" } }, "required": [ "msisdn", "country" ] } } }, "required": true }, "RCSCapabilityBulkCheckRequest": { "content": { "application/json": { "schema": { "type": "object", "properties": { "users": { "type": "array", "items": { "type": "string", "example": "447900000000" }, "description": "An array of phone numbers to check.", "example": [ "447900000000", "447900000001" ] } } } } } }, "RCSOptOutUpdateRequest": { "description": "The request body for the operation.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RCSOptOutInfo" } } }, "required": true }, "RCSBrandRequestV1": { "description": "The request body for the operation.", "content": { "application/json": { "schema": { "type": "object", "properties": { "display_name": { "type": "string", "description": "The name of the RCS Brand.", "example": "My RCS Brand" } }, "required": [ "display_name" ] } } }, "required": true }, "RCSCreateBrandRequestV2": { "description": "The request body for the operation.", "content": { "application/json": { "schema": { "type": "object", "properties": { "display_name": { "type": "string", "maxLength": 100, "minLength": 0, "description": "The name of the RCS Brand.", "example": "My RCS Brand" }, "details": { "$ref": "#/components/schemas/RCSBrandDetailsV2" } }, "required": [ "display_name" ] } } }, "required": true }, "RCSUpdateBrandRequestV2": { "description": "Brand display name and/or details to update.", "content": { "application/json": { "schema": { "type": "object", "properties": { "display_name": { "type": "string", "maxLength": 100, "minLength": 0, "description": "The name of the RCS Brand.", "example": "My RCS Brand" }, "details": { "$ref": "#/components/schemas/RCSBrandDetailsV2" } } } } }, "required": true }, "RCSAgentRequestv1": { "description": "The request body for the operation.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RCSAgentv1" } } }, "required": true }, "RCSCreateAgentRequestV2": { "description": "The request body for the operation.", "content": { "application/json": { "schema": { "type": "object", "properties": { "basic_info": { "$ref": "#/components/schemas/RCSAgentBasicInfoV2" }, "visual_design": { "$ref": "#/components/schemas/RCSAgentVisualDesignV2" }, "application_settings": { "$ref": "#/components/schemas/RCSAgentApplicationSettingsV2" }, "representative": { "$ref": "#/components/schemas/RCSAgentRepresentativeV2" }, "carrier_requirements": { "$ref": "#/components/schemas/RCSAgentCarrierRequirementsV2" }, "carriers": { "type": "array", "description": "List of carrier identifiers to launch the agent on. Available carrier IDs can be retrieved from the /v2/channel-manager/rcs/metadata/carriers endpoint.", "example": [ "vodafone-germany", "dt-germany" ], "items": { "type": "string" }, "minItems": 1 } }, "required": [ "basic_info", "visual_design", "application_settings", "carriers" ] } } }, "required": true }, "RCSUpdateAgentRequestV2": { "description": "The request body for the operation.", "content": { "application/json": { "schema": { "type": "object", "properties": { "basic_info": { "$ref": "#/components/schemas/RCSAgentBasicInfoV2" }, "visual_design": { "$ref": "#/components/schemas/RCSAgentVisualDesignV2" }, "application_settings": { "$ref": "#/components/schemas/RCSAgentApplicationSettingsV2" }, "representative": { "$ref": "#/components/schemas/RCSAgentRepresentativeV2" }, "carrier_requirements": { "$ref": "#/components/schemas/RCSAgentCarrierRequirementsV2" }, "carriers": { "type": "array", "items": { "type": "string" }, "minItems": 1 } }, "required": [ "basic_info", "visual_design", "application_settings", "carriers", "carrier_requirements", "representative" ] } } }, "required": true }, "RCSPartiallyUpdateAgentRequestV2": { "description": "The request body for the operation.", "content": { "application/json": { "schema": { "type": "object", "properties": { "basic_info": { "$ref": "#/components/schemas/RCSAgentBasicInfoV2" }, "visual_design": { "$ref": "#/components/schemas/RCSAgentVisualDesignV2" }, "application_settings": { "$ref": "#/components/schemas/RCSAgentApplicationSettingsV2" }, "representative": { "$ref": "#/components/schemas/RCSAgentRepresentativeV2" }, "carrier_requirements": { "$ref": "#/components/schemas/RCSAgentCarrierRequirementsV2" }, "carriers": { "type": "array", "items": { "type": "string" } } } } } }, "required": true }, "RCSAddCarriersToAgentRequestv1": { "description": "The request body for the operation.", "content": { "application/json": { "schema": { "type": "object", "properties": { "carriers": { "type": "array", "items": { "$ref": "#/components/schemas/RCSCarrierIdv1" }, "description": "An array of Carrier IDs to add to the RCS Agent." } }, "required": [ "carriers" ] } } }, "required": true }, "RCSAddCarriersToAgentRequestV2": { "description": "The request body for the operation.", "content": { "application/json": { "schema": { "type": "object", "properties": { "carriers": { "type": "array", "items": { "$ref": "#/components/schemas/RCSCarrierIdV2" }, "description": "An array of Carrier IDs to add to the RCS Agent.", "minItems": 1 } }, "required": [ "carriers" ] } } }, "required": true }, "RCSAddTestDevicesToAgentRequestv1": { "description": "The request body for the operation.", "content": { "application/json": { "schema": { "type": "object", "properties": { "phone": { "type": "string", "description": "The phone number to add to the RCS Agent in E.164 format.", "example": "+14155552671" } }, "required": [ "phone" ] } } }, "required": true }, "RCSAddTestDevicesToAgentRequestV2": { "description": "The request body for the operation.", "content": { "application/json": { "schema": { "type": "object", "properties": { "phone": { "type": "string", "description": "The phone number to add to the RCS Agent in E.164 format.", "example": "+14155552671" } }, "required": [ "phone" ] } } }, "required": true }, "RCSDeeplinkRequest": { "description": "The request body for the operation.", "content": { "application/json": { "schema": { "type": "object", "properties": { "sender_id": { "type": "string", "description": "Messages API sender ID (a.k.a. external ID) that identifies the RCS agent.", "example": "acme_agent", "minLength": 0, "maxLength": 50 }, "country": { "type": "string", "description": "ISO 3166-1 alpha-2 country code of the country where the deep link will operate.", "example": "US", "minLength": 2, "maxLength": 2 }, "prefilled_message": { "type": "string", "description": "Optional pre-defined message that will be populated in the send-message dialog of the SMS/RCS app on the end user's device when the user opens the deep link.", "example": "I'm interested in finding out about your new product. Please send me more details.", "minLength": 0, "maxLength": 3072 }, "fallback_number": { "type": "string", "description": "Optional Vonage virtual number in E.164 format that will be used as the SMS fallback destination if the end user's device does not support RCS.", "example": "+15550123456" } }, "required": [ "sender_id", "country" ] } } }, "required": true } }, "schemas": { "Granularity": { "type": "string", "enum": [ "HALF_HOUR", "DAILY", "MONTHLY" ], "example": "DAILY" }, "TemplateGranularity": { "type": "string", "enum": [ "DAILY" ], "example": "DAILY" }, "VonageApiKey": { "type": "string", "description": "The API key of the Vonage account associated with the WhatsApp Business Account.", "example": "abc123" }, "WhatsAppWabaId": { "type": "string", "description": "The ID of the WhatsApp Business Account.", "example": "345688589250625" }, "WhatsAppWabaNumberId": { "type": "string", "description": "The ID of the phone number associated with the WhatsApp Business Account.", "example": "293464193855848" }, "WhatsAppTemplateId": { "type": "string", "description": "The ID of the WhatsApp Template which the analytics data is for.", "example": "458951126288942" }, "WhatsAppAnalyticsStart": { "type": "string", "format": "timestamp", "description": "The UNIX timestamp for the start of the data point range.", "example": "1543543200" }, "WhatsAppAnalyticsEnd": { "type": "string", "format": "timestamp", "description": "The UNIX timestamp for the end of the data point range.", "example": "1543629600" }, "WhatsAppCountryCode": { "type": "string", "description": "The country of the WhatsApp Business Account's owning Meta Business account.", "example": "US" }, "WhatsAppWaba": { "type": "object", "required": [ "waba_id", "api_key", "name", "account_review_status", "timezone_id", "currency" ], "properties": { "waba_id": { "$ref": "#/components/schemas/WhatsAppWabaId" }, "api_key": { "$ref": "#/components/schemas/VonageApiKey" }, "name": { "type": "string", "description": "The name of the WhatsApp Business Account.", "example": "My Business" }, "account_review_status": { "type": "string", "description": "The review status of the WhatsApp Business Account.", "enum": [ "Pending", "Approved", "Rejected" ], "example": "Approved" }, "timezone_id": { "type": "string", "description": "The ID of the timezone of the WhatsApp Business Account.", "example": "58" }, "currency": { "type": "string", "description": "The currency of the WhatsApp Business Account.", "example": "USD" }, "solution_id": { "type": "string", "description": "The ID of the solution of the WhatsApp Business Account. Applies for WABAs onboarded through a partner solution", "example": "1234567890" }, "country": { "$ref": "#/components/schemas/WhatsAppCountryCode" }, "business_id": { "type": "string", "description": "ID of the business manager or portfolio that contains the WhatsApp Business Account", "example": "224654643345" }, "business_name": { "type": "string", "description": "Name of the business manager or portfolio that contains the WhatsApp Business Account", "example": "Vonage Communication APIs & Conversational Commerce Platform" }, "status": { "type": "string", "description": "WhatsApp Business Account status", "example": "ACTIVE", "enum": [ "ACTIVE", "INELIGIBLE", "NOT_STARTED", "INELIGBLE_ON_BEHALF_OF_WABA", "PENDING", "DELETED", "MIGRATED", "BANNED", "RESTRICTED", "RATE_LIMITED", "FLAGGED", "CONNECTED", "DISCONNECTED", "UNKNOWN", "UNVERIFIED", "OFFLINE" ], "default": "ACTIVE" }, "whatsapp_business_manager_messaging_limit": { "type": "string", "description": "Maximum number of unique WhatsApp user phone numbers that your Business Manager account can message, outside of a customer service window, within a moving 24-hour period. This limit is shared across all WhatsApp phone numbers owned by your business.\n\nFor more information on messaging limits see the [Meta documentation](https://developers.facebook.com/documentation/business-messaging/whatsapp/messaging-limits).\n", "example": "TIER_10K", "enum": [ "TIER_100K", "TIER_10K", "TIER_250", "TIER_2K", "TIER_UNLIMITED", "UNTIERED" ] }, "marketing_messages_onboarding_status": { "type": "string", "description": "Onboarding status of the WhatsApp Business account into Marketing Messages API.", "example": "ELIGIBLE", "enum": [ "INELIGIBLE_ON_BEHALF_OF_WABA", "INELIGIBLE_INACTIVE_OR_RESTRICTED", "INELIGIBLE_COUNTRY_NOT_SUPPORTED", "INELIGIBLE_USING_WHATSAPP_BUSINESS_APP", "ELIGIBLE", "PENDING_VALID_PAYMENT_METHOD", "PENDING_INTERNAL_SETUP", "ONBOARDED" ] } } }, "WhatsAppWabaNumber": { "type": "object", "required": [ "phone_number", "waba_id", "number_id", "api_key" ], "properties": { "phone_number": { "type": "string", "format": "e164", "pattern": "^[1-9]\\d{1,14}$", "description": "The phone number associated with the WhatsApp Business Account.", "example": "447451277751" }, "number_id": { "$ref": "#/components/schemas/WhatsAppWabaNumberId" }, "waba_id": { "$ref": "#/components/schemas/WhatsAppWabaId" }, "api_key": { "$ref": "#/components/schemas/VonageApiKey" }, "verified_name": { "type": "string", "description": "The WhatsApp display name for number", "example": "My Business" }, "code_verification_status": { "type": "string", "description": "Indicates the phone number's one-time password (OTP) verification status.\n - Only phone numbers with a `VERIFIED` status can be registered.\n - An `EXPIRED` status means that the phone number was previously verified but the 14 day verification period has ended. If the phone number is not registered, it will need to be verified again.\n", "enum": [ "NOT_VERIFIED", "VERIFIED", "EXPIRED" ], "example": "VERIFIED" }, "display_phone_number": { "type": "string", "description": "How the number is displayed on WhatsApp accounts.", "example": "+447451277751" }, "messaging_limit_tier": { "type": "string", "description": "The messaging limit tier of the phone number. See [WhatsApp messaging limits](https://developers.facebook.com/docs/whatsapp/messaging-limits/)", "example": "TIER_100K", "enum": [ "TIER_50", "TIER_250", "TIER_1K", "TIER_10K", "TIER_100K", "TIER_UNLIMITED" ] }, "quality_score": { "type": "object", "description": "The quality score of the phone number. See [WhatsApp Business phone number’s quality rating](https://www.facebook.com/business/help/896873687365001)", "properties": { "score": { "type": "string", "description": "The quality score of the phone number.\n - GREEN: High quality\n - YELLOW: Medium quality\n - RED: Low quality\n", "example": "GREEN", "enum": [ "GREEN", "YELLOW", "RED" ] } } }, "throughput": { "type": "object", "description": "The throughput level of the phone number. Indication of throughput permissible by WhatsApp e.g. `STANDARD` is the default 80 messages/sec", "properties": { "level": { "type": "string", "description": "The throughput rate of the phone number.", "example": "STANDARD" } } } } }, "WhatsAppWabaNumberProfileMessagingProduct": { "type": "string", "description": "The messaging product with which the profile is associated.", "enum": [ "whatsapp" ], "example": "whatsapp" }, "WhatsAppWabaNumberProfileCommon": { "type": "object", "properties": { "about": { "type": "string", "description": "Information about the profile", "example": "About my business" }, "address": { "type": "string", "description": "The address of the profile", "example": "123 Main Street, Anytown, USA" }, "description": { "type": "string", "description": "The description of the profile", "example": "Description of my business" }, "email": { "type": "string", "description": "The email address of the profile", "example": "bob@example.com" }, "profile_picture_url": { "type": "string", "format": "uri", "description": "URL of picture for the profile. Profile picture must be a square JPG or PNG, with min dimensions of 192px x 192px, and max dimensions of 640 px x 640 px, and a max file size of 800 kb. If the image is larger, it will get automatically centre-cropped to fit these dimensions\n", "example": "https://example.com/profile.png" }, "websites": { "type": "array", "items": { "type": "string", "format": "uri" }, "description": "URLs of websites for the profile", "example": [ "https://example.com", "https://example.org" ] }, "vertical": { "type": "string", "description": "The Industry or Business Category of the WhatsApp Profile", "example": "OTHER", "enum": [ "APPAREL", "AUTO", "BEAUTY", "EDU", "ENTERTAIN", "EVENT_PLAN", "FINANCE", "GOVT", "GROCERY", "HEALTH", "HOTEL", "NONPROFIT", "OTHER", "PROF_SERVICES", "RESTAURANT", "RETAIL", "TRAVEL" ] } } }, "WhatsAppAnalyticsSentMessagesCount": { "type": "integer", "description": "The number of messages sent using the WhatsApp Template.", "example": 100 }, "WhatsAppTemplateAnalyticsData": { "type": "object", "required": [ "template_id", "start", "end" ], "properties": { "template_id": { "$ref": "#/components/schemas/WhatsAppTemplateId" }, "start": { "$ref": "#/components/schemas/WhatsAppAnalyticsStart" }, "end": { "$ref": "#/components/schemas/WhatsAppAnalyticsEnd" }, "sent": { "$ref": "#/components/schemas/WhatsAppAnalyticsSentMessagesCount" }, "delivered": { "type": "integer", "description": "The number of messages delivered using the WhatsApp Template.", "example": 90 }, "read": { "type": "integer", "description": "The number of messages read using the WhatsApp Template.", "example": 80 }, "clicked": { "type": "integer", "description": "The number of messages clicked using the WhatsApp Template.", "example": 70 } } }, "WhatsAppMessagingAnalyticsData": { "type": "object", "required": [ "start", "end", "sent", "delivered" ], "properties": { "start": { "$ref": "#/components/schemas/WhatsAppAnalyticsStart" }, "end": { "$ref": "#/components/schemas/WhatsAppAnalyticsEnd" }, "sent": { "$ref": "#/components/schemas/WhatsAppAnalyticsSentMessagesCount" }, "delivered": { "type": "integer", "description": "The number of messages delivered within the data point range.", "example": 90 } } }, "WhatsAppPricingAnalyticsData": { "type": "object", "properties": { "start": { "$ref": "#/components/schemas/WhatsAppAnalyticsStart" }, "end": { "$ref": "#/components/schemas/WhatsAppAnalyticsEnd" }, "volume": { "type": "integer", "description": "The number of messages sent.", "example": 100 }, "phone_number": { "type": "string", "format": "e164", "pattern": "^[1-9]\\d{1,14}$", "description": "The phone number associated with the Messaging Analytics.", "example": "14155552671" }, "country": { "type": "string", "description": "The country for the phone number associated with the Messaging Analytics.", "example": "US" }, "tier": { "type": "string", "description": "The pricing tier for the messages related to the Messaging Analytics.", "example": "75000:150000" }, "pricing_type": { "type": "string", "description": "The pricing type for the messages related to the Messaging Analytics.", "example": "REGULAR" }, "pricing_category": { "type": "string", "description": "The pricing category for the messages related to the Messaging Analytics.", "example": "AUTHENTICATION" } } }, "WhatsAppSubscription": { "type": "object", "properties": { "label": { "type": "string", "description": "An optional label for the subscription", "example": "My WhatsApp Subscription" }, "whatsapp_subscribe_types": { "type": "string", "description": "A comma-separated list of the WhatsApp notification types that the subscription is for.\nSupports all the notification types available for WhatsApp accounts listed [here](https://developers.facebook.com/docs/graph-api/webhooks/reference/whatsapp-business-account/).\nWhen a new subscription is created, if this parameter is not specified then the subscription will include all of the subscription types.\n", "example": "account_alerts,account_update" }, "vonage_subscribe_types": { "type": "string", "description": "A comma-separated list of the Vonage notification types that the subscription is for.\n", "example": "vonage_number_onboarded", "enum": [ "vonage_number_onboarded" ] }, "created_at": { "type": "string", "description": "The date and time when the subscription was created, in ISO-8601 format.", "example": "2024-11-01T12:00:00Z" }, "id": { "type": "string", "description": "The unique ID of the subscription", "example": "9fa85698-c92a-4786-be0e-b5a489425120" } } }, "WhatsAppSubscriptionSlack": { "allOf": [ { "$ref": "#/components/schemas/WhatsAppSubscription" }, { "title": "Slack Subscription", "required": [ "slack" ], "properties": { "type": { "type": "string", "description": "The subscription type", "enum": [ "slack" ], "example": "slack" }, "slack": { "type": "object", "description": "The Slack hook configuration for the subscription, where the subscription type is `slack`.", "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "description": "The URL of the Slack hook to which the WhatsApp notifications will be sent", "example": "https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX" } } } } } ], "example": { "id": "9fa85698-c92a-4786-be0e-b5a489425120", "type": "slack", "label": "My WhatsApp Slack Subscription", "whatsapp_subscribe_types": "account_alerts,account_update", "vonage_subscribe_types": "vonage_number_onboarded", "created_at": "2024-11-01T12:00:00Z", "slack": { "url": "https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX" } } }, "WhatsAppSubscriptionWebhook": { "allOf": [ { "$ref": "#/components/schemas/WhatsAppSubscription" }, { "title": "Webhook Subscription", "required": [ "webhook" ], "properties": { "webhook": { "type": "object", "description": "The webhook configuration for the subscription, where the subscription type is `webhook`.", "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "description": "The URL of the webhook to which the WhatsApp notifications will be sent", "example": "https://my.server.com/webhooks/whatsapp-notifications" } } } } } ], "example": { "id": "8bceefe2-ebc8-4aa6-a4a3-73d837b3d416", "type": "webhook", "label": "My WhatsApp Webhook Subscription", "whatsapp_subscribe_types": "account_alerts,account_update", "vonage_subscribe_types": "vonage_number_onboarded", "created_at": "2024-11-01T12:00:00Z", "webhook": { "url": "https://example.com/webhook" } } }, "WhatsAppErrorInvalidPropertyProfileVertical": { "description": "Invalid Property Value - Vertical", "type": "object", "required": [ "type", "title", "details", "instance" ], "properties": { "type": { "type": "string", "description": "Link to error / remediation options", "example": "https://developer.vonage.com/api-errors/messages" }, "title": { "type": "string", "description": "Generic error message", "example": "Provider error" }, "detail": { "type": "string", "description": "Additional information about the error", "example": "Param `business_category` must be one of {OTHER, AUTO, BEAUTY, APPAREL, EDU, ENTERTAIN, EVENT_PLAN, FINANCE, GROCERY, GOVT, HOTEL, HEALTH, NONPROFIT, PROF_SERVICES, RETAIL, TRAVEL, RESTAURANT}.\n" }, "instance": { "type": "string", "description": "Internal Trace ID", "example": "d929f1b2-5d31-4f79-9826-b4a6e47e9a02" } } }, "WhatsAppErrorInvalidPropertyProfileProfilePictureUrlFileError": { "description": "Invalid Property Value - Profile Picture URL File Error", "type": "object", "required": [ "type", "title", "details", "instance" ], "properties": { "type": { "type": "string", "description": "Link to error / remediation options", "example": "https://developer.vonage.com/api-errors" }, "title": { "type": "string", "description": "Generic error message", "example": "File error" }, "detail": { "type": "string", "description": "Additional information about the error", "example": "Fail to download file" }, "instance": { "type": "string", "description": "Internal Trace ID", "example": "d929f1b2-5d31-4f79-9826-b4a6e47e9a02" } } }, "WhatsAppErrorInvalidPropertyProfileProfilePictureUrlLowResolution": { "description": "Invalid Property Value - Profile Picture URL Low Resolution", "type": "object", "required": [ "type", "title", "details", "instance" ], "properties": { "type": { "type": "string", "description": "Link to error / remediation options", "example": "https://developer.vonage.com/api-errors" }, "title": { "type": "string", "description": "Generic error message", "example": "Uploaded profile image resolution is low" }, "detail": { "type": "string", "description": "Additional information about the error", "example": "Please upload JPG image of resolution greater than 192 pixel * 192 pixel" }, "instance": { "type": "string", "description": "Internal Trace ID", "example": "977b9de9-9d4a-4279-816a-21decfd934ed" } } }, "WhatsAppErrorInvalidPropertyProfileWebsitesInvalidUrls": { "description": "Invalid Property Value - Websites Invalid URLs", "type": "object", "required": [ "type", "title", "details", "instance" ], "properties": { "type": { "type": "string", "description": "Link to error / remediation options", "example": "https://developer.vonage.com/api-errors" }, "title": { "type": "string", "description": "Generic error message", "example": "Provider error" }, "detail": { "type": "string", "description": "Additional information about the error", "example": "Param `websites` must contain only valid URIs and each link must be at most 256 characters long" }, "instance": { "type": "string", "description": "Internal Trace ID", "example": "148c4ab6-94bd-47d0-91af-61ab9de70a3d" } } }, "WhatsAppErrorWabaNotFound": { "description": "WABA Not Found", "type": "object", "required": [ "type", "title", "details", "instance" ], "properties": { "type": { "type": "string", "description": "Link to error / remediation options", "example": "https://developer.vonage.com/api-errors/messages#not-found" }, "title": { "type": "string", "description": "Generic error message", "example": "WABA Not Found" }, "detail": { "type": "string", "description": "Additional information about the error", "example": "WABA does not exist or you do not have access." }, "instance": { "type": "string", "description": "Internal Trace ID", "example": "bf0ca0bf927b3b52e3cb03217e1a1ddf" } } }, "WhatsAppErrorNumberNotFound": { "description": "Number Not Found", "type": "object", "required": [ "type", "title", "details", "instance" ], "properties": { "type": { "type": "string", "description": "Link to error / remediation options", "example": "https://developer.vonage.com/api-errors/messages#not-found" }, "title": { "type": "string", "description": "Generic error message", "example": "Number Not Found" }, "detail": { "type": "string", "description": "Additional information about the error", "example": "Number does not exist or you do not have access." }, "instance": { "type": "string", "description": "Internal Trace ID", "example": "bf0ca0bf927b3b52e3cb03217e1a1ddf" } } }, "WhatsAppErrorProfileNotFound": { "description": "Profile Not Found", "type": "object", "required": [ "type", "title", "details", "instance" ], "properties": { "type": { "type": "string", "description": "Link to error / remediation options", "example": "https://developer.vonage.com/api-errors/messages#not-found" }, "title": { "type": "string", "description": "Generic error message", "example": "Number Not Found" }, "detail": { "type": "string", "description": "Additional information about the error", "example": "Profile does not exist or you do not have access." }, "instance": { "type": "string", "description": "Internal Trace ID", "example": "bf0ca0bf927b3b52e3cb03217e1a1ddf" } } }, "WhatsAppErrorSubscriptionAlreadyExists": { "description": "WhatsApp Subscription Already Exists", "type": "object", "required": [ "type", "title", "detail", "instance" ], "properties": { "type": { "type": "string", "description": "Link to error / remediation options", "example": "https://developer.vonage.com/api-errors/" }, "title": { "type": "string", "description": "Generic error message", "example": "Subscription already exists" }, "detail": { "type": "string", "description": "Additional information about the error", "example": "Subscription of type: 'webhook' with value: 'http://localhost23' already exists" }, "instance": { "type": "string", "description": "Internal Trace ID", "example": "bf0ca0bf927b3b52e3cb03217e1a1ddf" } } }, "RCSFeature": { "type": "string", "enum": [ "RICHCARD_STANDALONE", "RICHCARD_CAROUSEL", "ACTION_CREATE_CALENDAR_EVENT", "ACTION_DIAL", "ACTION_OPEN_URL", "ACTION_SHARE_LOCATION", "ACTION_VIEW_LOCATION" ], "example": "ACTION_CREATE_CALENDAR_EVENT" }, "RCSAgentIdv1": { "type": "string", "format": "uuid", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$", "description": "The unique ID of the created RCS Agent.", "example": "78d335fa-323d-0114-9c3d-d6f0d48968cf" }, "RCSAgentIdV2": { "type": "string", "format": "uuid", "description": "The unique ID of the created RCS Agent.", "example": "78d335fa-323d-0114-9c3d-d6f0d48968cf" }, "RCSDeviceIdv1": { "type": "string", "format": "uuid", "description": "The unique ID of the created test device.", "example": "78d335fa-323d-0114-9c3d-d6f0d48968cf" }, "RCSDeviceIdV2": { "type": "string", "format": "uuid", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$", "description": "The unique ID of the test device.", "example": "78d335fa-323d-0114-9c3d-d6f0d48968cf" }, "RCSCarrierIdv1": { "type": "string", "description": "A unique identifier for the carrier.", "example": "verizon-us" }, "RCSCarrierIdV2": { "type": "string", "description": "A unique identifier for the carrier.", "example": "verizon-us" }, "RCSHostingRegionv1": { "type": "string", "enum": [ "NORTH_AMERICA", "EUROPE", "ASIA_PACIFIC" ], "description": "The geographic location where your RCS business messaging service will be hosted and operated.\nThis can affect data residency and compliance requirements.\n", "example": "NORTH_AMERICA" }, "RCSHostingRegionV2": { "type": "string", "enum": [ "NORTH_AMERICA", "EUROPE", "ASIA_PACIFIC" ], "description": "The geographic location where your RCS business messaging service will be hosted and operated.\nThis can affect data residency and compliance requirements.\n", "example": "NORTH_AMERICA" }, "RCSAgentPurposev1": { "type": "string", "enum": [ "PROMOTIONAL", "TRANSACTIONAL", "OTP", "MULTI_USE" ], "description": "Specifies the intended use of the RCS Agent. This cannot be changed after creation.", "example": "TRANSACTIONAL" }, "RCSAgentPurposeV2": { "type": "string", "enum": [ "PROMOTIONAL", "TRANSACTIONAL", "OTP", "MULTI_USE" ], "description": "Specifies the intended use of the RCS Agent. This cannot be changed after creation.", "example": "TRANSACTIONAL" }, "RCSBillingCategoryv1": { "type": "string", "enum": [ "CONVERSATIONAL", "NON_CONVERSATIONAL" ], "description": "Specifies the billing category of the RCS Agent.", "example": "CONVERSATIONAL" }, "RCSBillingCategoryV2": { "type": "string", "enum": [ "SINGLE_MESSAGE", "BASIC_MESSAGE", "CONVERSATIONAL", "NON_CONVERSATIONAL" ], "description": "Specifies the billing category of the RCS Agent.", "example": "CONVERSATIONAL" }, "RCSCapabilitiesBulkCheckUsersResponse": { "type": "object", "properties": { "reachableUsers": { "type": "array", "items": { "type": "string", "example": "447900000000" }, "description": "A list of specific numbers for devices that reachable for RCS messaging.", "example": [ "447900000000", "447900000001" ] } }, "description": "Response where 500 numbers or less submitted." }, "RCSCapabilitiesBulkCheckSampleResponse": { "type": "object", "properties": { "totalRandomSampleUserCount": { "type": "string", "description": "The number of submitted numbers that were used as part of the sample.", "example": "632" }, "reachableRandomSampleUserCount": { "type": "string", "description": "The number of sampled numbers associated with devices that are reachable for RCS messaging.", "example": "324" } }, "description": "Response where more than 500 numbers submitted." }, "RCSOptOutInfo": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Indicates if opt-out is enabled for the user.", "example": true }, "actions": { "type": "array", "items": { "type": "object", "properties": { "keywords": { "type": "array", "items": { "type": "string", "example": "STOP" }, "description": "A list of keywords that trigger the action." }, "auto-reply": { "type": "string", "description": "The auto-reply message sent when the action is triggered.", "example": "You have opted out." }, "action": { "type": "string", "enum": [ "STOP", "START", "CUSTOM" ], "description": "The type of action.", "example": "STOP" } }, "required": [ "keywords", "auto-reply", "action" ] }, "description": "A list of actions available for opt-out." } }, "required": [ "actions" ] }, "RCSBrandV1": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$", "description": "The unique ID of the RCS Brand.", "example": "78d335fa-323d-0114-9c3d-d6f0d48968cf" }, "display_name": { "type": "string", "description": "The name of the RCS Brand.", "example": "My RCS Brand" } }, "required": [ "id", "display_name" ] }, "RCSBrandV2": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "description": "The unique ID of the RCS Brand.", "example": "78d335fa-323d-0114-9c3d-d6f0d48968cf" }, "display_name": { "type": "string", "maxLength": 100, "minLength": 0, "description": "The name of the RCS Brand.", "example": "My RCS Brand" }, "details": { "$ref": "#/components/schemas/RCSBrandDetailsV2" } }, "required": [ "id", "display_name" ] }, "RCSBrandDetailsV2": { "type": "object", "properties": { "organization_name": { "type": "string", "description": "Legal organization name", "example": "Acme Corporation", "maxLength": 255, "minLength": 0 }, "legal_form": { "type": "string", "description": "Legal form of the organization. When a standard value matches your case, use it exactly as listed to ensure consistency.\n\nStandard values for US entities:\n- Limited liability company (LLC)\n- Corporation (C-corp)\n- Benefit Corporation (B-corp)\n- Partnership (General or Limited)\n- Nonprofit or Foundation\n- Sole proprietorship\n\nStandard values for non-US entities:\n- Private limited company\n- Public limited company\n- Sole proprietorship\n- Partnership\n- Nonprofit or Foundation\n\nCustom values are accepted when none of the above apply.\n", "example": "Limited liability company (LLC)", "maxLength": 50, "minLength": 0 }, "stock_symbol": { "type": "string", "description": "Stock symbol of the organization, if publicly traded", "example": "ACME", "maxLength": 12, "minLength": 0 }, "legal_entity_type": { "type": "string", "description": "Type of legal entity. When a standard value matches your case, use it exactly as listed to ensure consistency.\n\nStandard values:\n- Public\n- Private\n- Government\n- Non-profit\n- Sole proprietor\n\nCustom values are accepted when none of the above apply.\n", "example": "Private", "maxLength": 50, "minLength": 0 }, "country_of_registration": { "type": "string", "description": "ISO 3166-1 alpha-2 country code of registration", "example": "US", "maxLength": 2, "minLength": 2, "pattern": "^[A-Z]{2}$" }, "federal_tax_id": { "type": "string", "description": "Federal tax identification number (required for US entities)", "example": "12-3456789", "maxLength": 50, "minLength": 0 }, "business_website_url": { "type": "string", "description": "Business website URL of the organization", "example": "https://www.example.com", "pattern": "^(http|https)://.*$", "maxLength": 255, "minLength": 0 }, "address_line1": { "type": "string", "description": "Primary address line", "example": "One Main Street", "maxLength": 255, "minLength": 0 }, "address_line2": { "type": "string", "description": "Secondary address line", "example": "Suite 100", "maxLength": 255, "minLength": 0 }, "city": { "type": "string", "description": "City name", "example": "San Francisco", "maxLength": 100, "minLength": 0 }, "state_or_province": { "type": "string", "description": "State or province name", "example": "California", "maxLength": 100, "minLength": 0 }, "zip_or_post_code": { "type": "string", "description": "ZIP or postal code", "example": "SW1A 1AA", "maxLength": 15, "minLength": 0 } }, "required": [ "address_line1", "business_website_url", "city", "country_of_registration", "legal_entity_type", "legal_form", "organization_name", "state_or_province", "zip_or_post_code" ] }, "RCSAgentv1": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/RCSAgentIdv1" }, "state": { "type": "string", "description": "The current state of the created RCS Agent.", "example": "DRAFT" }, "application_settings": { "$ref": "#/components/schemas/RCSAgentApplicationSettings" }, "basic_info": { "type": "object", "properties": { "brand_id": { "$ref": "#/components/schemas/RCSBrandV1/properties/id" }, "display_name": { "type": "string", "description": "The unique display name of the RCS Agent.", "example": "Example Co" }, "sender_id": { "type": "string", "description": "A unique sender identifier on the Vonage platform. This cannot be blank, include whitespaces, or be changed after creation.\nThe sender ID is used as the `from` value when sending RCS messages via the Messages API.\n", "example": "ExampleCo-RCSAgentv1-1" }, "hosting_region": { "$ref": "#/components/schemas/RCSHostingRegionv1" }, "agent_purpose": { "$ref": "#/components/schemas/RCSAgentPurposev1" }, "billing_category": { "$ref": "#/components/schemas/RCSBillingCategoryv1" }, "notes": { "type": "string", "description": "Additional notes or comments about the RCS Agent.\n\n**DEPRECATED** This parameter is deprecated and will be removed in future. It can still be included in the request for backward compatibility, but it will not have any effect on the RCS Agent.\n", "example": "This agent is used for transactional messages only." } }, "required": [ "brand_id", "display_name", "sender_id", "hosting_region", "agent_purpose", "billing_category" ] }, "carrier_requirements": { "type": "object", "properties": { "agent_preview": { "type": "object", "properties": { "agent_access_instructions": { "type": "string", "description": "Agent access instructions specify how reviewers and testers can access and interact with your RBM agent during the review and testing phases before launch. \nThis property provides guidance on methods for triggering agent functionality and testing various features.\n", "example": "Provide a method for reviewers to trigger the agent, such as a website where reviewers can invite and add phone numbers. \nIf you need a list of phone numbers to add as test devices, contact rbm-support@vonage.com. \nTest the agent by sending a keyword like 'HELP' or 'START' to initiate conversation flow.\n" }, "urls": { "type": "array", "items": { "type": "object", "properties": { "media_type": { "type": "string", "enum": [ "image", "video" ], "description": "The media type of the agent preview.", "example": "image" }, "url": { "type": "string", "format": "uri", "description": "The URL to the agent preview.", "example": "https://www.example.com/rcs-agent-preview.jpg" } }, "required": [ "media_type" ] }, "maxItems": 10 } }, "required": [ "agent_access_instructions" ] }, "points_of_contact": { "type": "array", "items": { "allOf": [ { "$ref": "#/components/schemas/RCSAgentRepresentativev1" }, { "type": "object", "properties": { "job_title": { "type": "string", "maxLength": 200, "description": "The job title of the point of contact.", "example": "Technical Support" } }, "required": [ "job_title" ] } ] }, "maxItems": 5, "description": "A list of points of contact for the RCS Agent." }, "traffic_estimates": { "type": "object", "properties": { "average_global_traffic": { "type": "string", "enum": [ "THOUSAND", "TEN_THOUSAND", "FIFTY_THOUSAND", "HUNDRED_THOUSAND", "MILLION", "MILLION_AND_MORE" ], "description": "Estimated global traffic.", "example": "THOUSAND" }, "average_message_rate_per_user": { "type": "string", "enum": [ "ONCE_PER_MONTH", "2_4_TIMES_PER_MONTH", "ONCE_PER_WEEK", "2_6_TIMES_PER_WEEK", "DAILY", "MULTIPLE_TIMES_PER_DAY" ], "description": "Estimated message rate per user.", "example": "ONCE_PER_MONTH" }, "users_targeted": { "type": "string", "enum": [ "HUNDRED", "THOUSAND", "TEN_THOUSAND", "HUNDRED_THOUSAND", "HALF_MILLION", "MILLION", "MILLION_AND_MORE" ], "description": "Estimated number of users targeted.", "example": "HUNDRED" } }, "required": [ "average_global_traffic", "average_message_rate_per_user", "users_targeted" ], "description": "Traffic estimates for the RCS Agent." }, "user_experience": { "type": "object", "properties": { "interactions_description": { "type": "string", "maxLength": 10000, "description": "This field describes the primary and secondary types of interactions your RBM agent will have with users. \nIt outlines the conversational patterns, message types, and engagement scenarios your agent supports.\n", "example": "This agent handles customer support inquiries and provides product information. Primary interactions include order status updates, account notifications, and FAQ responses. \nSecondary interactions may include promotional offers for existing customers and appointment scheduling assistance.\n" }, "optin_description": { "type": "string", "maxLength": 10000, "description": "Details how users will provide consent to receive messages from your RBM agent. \nThis must clearly explain the opt-in mechanism and what users can expect when they subscribe to your messaging service.\n", "example": "This is a test environment. Customers consent to receive messages directly via request, phone, or email. \nUsers can opt-in by visiting our website and providing their phone number, or by texting 'JOIN' to our SMS shortcode. \nOpt-in confirmation includes details about message frequency and content type.\n" }, "optout_description": { "type": "string", "maxLength": 10000, "description": "Explains how users can unsubscribe from receiving messages from your agent. \nMust describe the process for users to stop receiving communications and how your system handles these requests.\n", "example": "Customers can unsubscribe from receiving messages by replying 'STOP' to any message. \nThey can also contact us by email at support@company.com. Users will receive a confirmation message when successfully unsubscribed, \nand can re-subscribe at any time by replying 'START'.\n" }, "trigger_description": { "type": "string", "maxLength": 10000, "description": "Defines the external events or conditions that will cause your RBM agent to initiate conversations with users. \nThese triggers determine when and why your agent sends the first message to users.\n", "example": "This account is used exclusively for sending test messages to introduce RCS capabilities to customers. \nTriggers include: order placement confirmations, shipping notifications, appointment reminders, customer service escalations, \nand weekly promotional campaigns for opted-in users.\n" } }, "required": [ "interactions_description", "optin_description", "optout_description", "trigger_description" ] } }, "required": [ "agent_preview", "points_of_contact", "traffic_estimates", "user_experience" ] }, "visual_design": { "type": "object", "properties": { "brand_color": { "type": "string", "description": "The hexadecimal color code for the primary color used in UI elements.\nThe specified color must meet WCAG 2.1 contrast ratio of 4.5:1 for legibility.\n", "example": "#8860CD" }, "email": { "type": "array", "items": { "type": "object", "properties": { "address": { "type": "string", "pattern": "^[^\\s@]+@[^\\s@]+.[^\\s@]+$", "description": "The contact email address for the RCS Agent.", "example": "support@example.com" }, "label": { "type": "string", "maxLength": 25, "description": "A label for the email address.", "example": "Customer Support" } }, "required": [ "address" ] } }, "phone": { "type": "array", "items": { "type": "object", "properties": { "number": { "$ref": "#/components/schemas/PhoneNumber" }, "label": { "type": "string", "maxLength": 25, "description": "A label for the phone number.", "example": "Customer Support" } }, "required": [ "number" ] } }, "tagline": { "type": "string", "maxLength": 100, "description": "A short phrase that represents the RCS Agent.", "example": "Your trusted partner in messaging." }, "website": { "type": "array", "items": { "type": "object", "properties": { "url": { "type": "string", "format": "uri", "example": "https://example.com" }, "label": { "type": "string", "maxLength": 25, "description": "A label for the website URL.", "example": "Company Website" } }, "required": [ "url" ] }, "maxItems": 3 }, "logo_image": { "type": "string", "format": "uri", "description": "A publicly available URL of the logo image for the RCS Agent. The image must be 224px x 224px, with minimum contrast ratio of 4.5:1 against a white background. Maximum file size of 50 KB.\nSupported types: \n - image/png \n - image/jpeg \n - image/jpg\n\nAny image file not meeting the requirements will result in an error response.\nThe logo image is not modifiable after agent verification.\n", "example": "https://agent-logos.storage.googleapis.com/_/mbsy6ycz7BnqOi4WKZlOmpkz" }, "banner_image": { "type": "string", "format": "uri", "description": "A publicly available URL of the hero image for the RCS Agent. The image must be 1440px x 448px, with minimum contrast ratio of 4.5:1 against a white background. Maximum file size of 200 KB.\nSupported types: \n - image/png \n - image/jpeg \n - image/jpg\n \nAny image file not meeting the requirements will result in an error response.\nThe banner image is not modifiable after agent verification.\n", "example": "https://agent-logos.storage.googleapis.com/_/mbsy64um0BwndPRK8ECPyeqb" }, "privacy_policy": { "type": "string", "format": "uri", "description": "The publicly accessible URL of the privacy policy for the RCS Agent.", "example": "https://www.example.com/privacy-policy" }, "terms_of_service": { "type": "string", "format": "uri", "description": "The publicly accessible URL of the terms of service for the RCS Agent.", "example": "https://www.example.com/terms-of-service" } }, "required": [ "brand_color", "email", "phone", "tagline", "website", "logo_image", "banner_image" ] }, "representative": { "$ref": "#/components/schemas/RCSAgentRepresentativev1" }, "created_at": { "type": "string", "description": "The date and time when the RCS Agent was created.", "example": "2023-01-01T12:00:00Z" }, "updated_at": { "type": "string", "description": "The date and time when the RCS Agent was last updated.", "example": "2023-01-01T12:00:00Z" } }, "required": [ "id", "basic_info" ] }, "RCSAgentAdditionalPropertiesv1": { "type": "object", "properties": { "test_devices": { "type": "array", "items": { "$ref": "#/components/schemas/RCSAgentTestDevicePropertiesv1" } }, "carriers": { "$ref": "#/components/schemas/RCSAgentCarrierPropertiesv1" }, "verification_details": { "$ref": "#/components/schemas/RCSAgentVerificationDetailsv1" }, "launch_submitted_at": { "type": "string", "description": "The date and time when the RCS Agent launch was submitted.", "example": "2023-01-01T12:00:00Z" } } }, "RCSAgentTestDevicePropertiesv1": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "description": "The id of the test device.", "example": "78d335fa-323d-0114-9c3d-d6f0d48968cf" }, "phone": { "$ref": "#/components/schemas/PhoneNumber" }, "status": { "type": "string", "description": "The current status of the test device.", "example": "ACCEPTED" }, "created_at": { "type": "string", "description": "The date and time when the test device was created.", "example": "2023-01-01T12:00:00Z" } }, "required": [ "id", "phone", "status", "created_at" ] }, "RCSAgentCarrierPropertiesv1": { "type": "object", "properties": { "id": { "type": "string", "description": "The id of the carrier.", "example": "att-us" }, "launch_state": { "type": "string", "enum": [ "LAUNCH_STATE_UNSPECIFIED", "LAUNCH_STATE_UNLAUNCHED", "LAUNCH_STATE_PENDING", "LAUNCH_STATE_LAUNCHED", "LAUNCH_STATE_REJECTED", "LAUNCH_STATE_SUSPENDED", "LAUNCH_STATE_PENDING_UNLAUNCH", "LAUNCH_STATE_INVALID_IN_GMB" ], "description": "The launch state of the carrier.", "example": "LAUNCH_STATE_UNLAUNCHED" } }, "required": [ "id" ] }, "RCSAgentVerificationDetailsv1": { "type": "object", "properties": { "status": { "type": "string", "description": "The verification status of the RCS Agent.", "example": "VERIFICATION_STATE_UNVERIFIED" } } }, "RCSAgentApplicationSettings": { "type": "object", "properties": { "application_id": { "type": "string", "format": "uuid", "description": "The id of the Vonage application with which to associate this agent.", "example": "78d335fa-323d-0114-9c3d-d6f0d48968cf" } }, "required": [ "application_id" ] }, "RCSAgentRepresentativev1": { "type": "object", "properties": { "first_name": { "type": "string", "maxLength": 200, "description": "The first name of the representative for the RCS Agent.", "example": "John" }, "last_name": { "type": "string", "maxLength": 200, "description": "The last name of the representative for the RCS Agent.", "example": "Doe" }, "email": { "type": "string", "pattern": "^[^\\s@]+@[^\\s@]+.[^\\s@]+$", "description": "The email address of the representative.", "example": "john.doe@example.com" }, "brand_website": { "type": "string", "format": "uri", "description": "The website URL of the brand represented by the RCS Agent.", "example": "https://www.example.com", "pattern": "^(http|https)://.*$" } }, "required": [ "first_name", "last_name", "email" ] }, "RCSCarrierDatav1": { "type": "object", "properties": { "carriers": { "type": "array", "items": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/RCSCarrierIdv1" }, "carrier": { "type": "string", "description": "The name of the carrier.", "example": "Verizon" }, "country_letter_code": { "type": "string", "description": "Code for the country where the carrier operates.", "example": "US" } } }, "description": "A list of available carriers for RCS." } }, "required": [ "carriers" ], "description": "Details of available Carriers that can be added to an RCS Agent." }, "RCSCarrierListV2": { "type": "object", "properties": { "carriers": { "type": "array", "items": { "$ref": "#/components/schemas/RCSCarrierV2" }, "description": "A list of available carriers for RCS." } }, "required": [ "carriers" ], "description": "Details of available Carriers that can be added to an RCS Agent." }, "RCSCarrierV2": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/RCSCarrierIdV2" }, "carrier": { "type": "string", "description": "The name of the carrier.", "example": "Verizon" }, "country_letter_code": { "type": "string", "description": "Code for the country where the carrier operates.", "example": "US" } }, "required": [ "id", "carrier", "country_letter_code" ] }, "RCSAgentListV2": { "type": "object", "properties": { "agents": { "type": "array", "items": { "$ref": "#/components/schemas/RCSAgentV2" }, "description": "A list of RCS Agents." } }, "required": [ "agents" ] }, "RCSAgentV2": { "type": "object", "required": [ "basic_info", "id" ], "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$", "description": "Unique agent identifier", "example": "0198ecd4-da21-7f8b-91d8-ccfbaec485a7" }, "state": { "type": "string", "description": "Current state of the agent", "enum": [ "DRAFT", "CREATED", "PENDING", "LAUNCHED", "REJECTED", "UNLAUNCHED" ], "example": "DRAFT" }, "basic_info": { "$ref": "#/components/schemas/RCSAgentBasicInfoV2" }, "visual_design": { "$ref": "#/components/schemas/RCSAgentVisualDesignV2" }, "application_settings": { "$ref": "#/components/schemas/RCSAgentApplicationSettingsV2" }, "test_devices": { "type": "array", "items": { "$ref": "#/components/schemas/RCSAgentTestDeviceV2" } }, "representative": { "$ref": "#/components/schemas/RCSAgentRepresentativeV2" }, "carrier_requirements": { "$ref": "#/components/schemas/RCSAgentCarrierRequirementsV2" }, "carriers": { "type": "array", "items": { "$ref": "#/components/schemas/RCSAgentPublicCarrierStatusV2" } }, "verification_details": { "$ref": "#/components/schemas/RCSAgentVerificationDetailsV2" }, "brand_details": { "$ref": "#/components/schemas/RCSAgentBrandDetailsV2" }, "launch_submitted_at": { "type": "string", "description": "Date and time when the agent launch was submitted" }, "created_at": { "type": "string", "description": "Date and time when the agent was created" }, "updated_at": { "type": "string", "description": "Date and time when the agent was last updated" } } }, "RCSAgentBasicInfoV2": { "type": "object", "properties": { "display_name": { "type": "string", "description": "Display name of the RCS agent shown to end users", "example": "Acme Bank", "maxLength": 40, "minLength": 0 }, "sender_id": { "type": "string", "pattern": "^[a-zA-Z0-9\\-_.]+$", "description": "Unique sender identifier for the agent", "example": "acme-bank", "maxLength": 50, "minLength": 0 }, "hosting_region": { "type": "string", "description": "Region where the agent is hosted", "enum": [ "NORTH_AMERICA", "EUROPE", "ASIA_PACIFIC" ], "example": "EUROPE" }, "agent_purpose": { "type": "string", "description": "Intended use case of the agent", "enum": [ "TRANSACTIONAL", "PROMOTIONAL", "OTP", "MULTI_USE" ], "example": "TRANSACTIONAL" }, "billing_category": { "type": "string", "description": "Billing category determining how messages are charged", "enum": [ "BASIC_MESSAGE", "SINGLE_MESSAGE", "CONVERSATIONAL", "NON_CONVERSATIONAL" ], "example": "CONVERSATIONAL" }, "brand_id": { "type": "string", "format": "uuid", "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$", "description": "Identifier of the brand this agent belongs to", "example": "0198ecd4-da21-7f8b-91d8-ccfbaec485a7", "maxLength": 100, "minLength": 0 }, "account_manager_email": { "type": "string", "pattern": "^[^\\s@]+@[^\\s@]+.[^\\s@]+$", "description": "Vonage account manager email address", "example": "manager@vonage.com" }, "reseller_email": { "type": "string", "pattern": "^[^\\s@]+@[^\\s@]+.[^\\s@]+$", "description": "Reseller email address, in case the agent is created by a reseller party", "example": "reseller@partner.com" } }, "required": [ "agent_purpose", "billing_category", "brand_id", "display_name", "hosting_region", "sender_id" ] }, "RCSAgentVisualDesignV2": { "type": "object", "properties": { "tagline": { "type": "string", "description": "Short tagline describing the agent or brand", "example": "Your trusted banking assistant", "maxLength": 100, "minLength": 0 }, "brand_color": { "type": "string", "description": "Brand color in hex format, used for button text and UI elements above the agent phone number. Must meet a minimum contrast ratio of 4.5:1 against white (WCAG 2.0). See the [support article](https://api.support.vonage.com/hc/en-us/articles/20710366656668)", "example": "#FF5733", "pattern": "^#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})$" }, "logo_image": { "type": "string", "description": "URL of the agent logo image. Shown as a circular avatar next to messages. Requirements: JPEG or PNG, 224x224 px, max 50 KB. See the [support article](https://api.support.vonage.com/hc/en-us/articles/20710366656668)", "example": "https://cdn.example.com/logo.png", "pattern": "^(http|https)://.*\\.(jpeg|jpg|png)$" }, "banner_image": { "type": "string", "description": "URL of the agent banner image. Displayed as a header when users view the agent business info. Requirements: JPEG, 1440x448 px, max 200 KB. See the [support article](https://api.support.vonage.com/hc/en-us/articles/20710366656668)", "example": "https://cdn.example.com/banner.png", "pattern": "^(http|https)://.*\\.(jpeg|jpg|png)$" }, "phone": { "type": "array", "description": "List of phone contact numbers (1-3)", "items": { "$ref": "#/components/schemas/RCSAgentPhoneV2" }, "maxItems": 3, "minItems": 0 }, "email": { "type": "array", "description": "List of email contact addresses (1-3)", "items": { "$ref": "#/components/schemas/RCSAgentEmailAddressV2" }, "maxItems": 3, "minItems": 0 }, "website": { "type": "array", "description": "List of website links (1-3)", "items": { "$ref": "#/components/schemas/RCSAgentWebsiteV2" }, "maxItems": 3, "minItems": 0 }, "privacy_policy": { "type": "string", "description": "URL of the privacy policy", "example": "https://www.example.com/privacy" }, "terms_of_service": { "type": "string", "description": "URL of the terms of service", "example": "https://www.example.com/terms" } }, "required": [ "brand_color", "email", "phone", "tagline", "website" ] }, "RCSAgentPhoneV2": { "type": "object", "properties": { "number": { "type": "string", "description": "Phone number in E.164 format", "example": "+12025551234", "pattern": "^\\+[1-9]\\d{1,14}$" }, "label": { "type": "string", "description": "Display label for this phone number", "example": "Customer Support", "maxLength": 25, "minLength": 0 } }, "required": [ "number" ] }, "RCSAgentEmailAddressV2": { "type": "object", "properties": { "address": { "type": "string", "pattern": "^[^\\s@]+@[^\\s@]+.[^\\s@]+$", "description": "Email address", "example": "support@example.com", "minLength": 1 }, "label": { "type": "string", "description": "Display label for this email address", "example": "Customer Support", "maxLength": 25, "minLength": 0 } }, "required": [ "address" ] }, "RCSAgentWebsiteV2": { "type": "object", "properties": { "url": { "type": "string", "description": "Website URL", "example": "https://www.example.com", "pattern": "^(http|https)://.*$" }, "label": { "type": "string", "description": "Display label for this website", "example": "Official Website", "maxLength": 25, "minLength": 0 } }, "required": [ "url" ] }, "RCSAgentApplicationSettingsV2": { "type": "object", "properties": { "application_id": { "type": "string", "description": "Vonage application ID to associate with this agent", "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$" } }, "required": [ "application_id" ] }, "RCSAgentRepresentativeV2": { "type": "object", "properties": { "first_name": { "type": "string", "description": "First name of the authorized representative", "example": "Jane", "maxLength": 200, "minLength": 0 }, "last_name": { "type": "string", "description": "Last name of the authorized representative", "example": "Doe", "maxLength": 200, "minLength": 0 }, "title": { "type": "string", "description": "Job title of the authorized representative", "example": "Head of Messaging", "maxLength": 200, "minLength": 0 }, "email": { "type": "string", "description": "Email address of the authorized representative", "example": "jane.doe@example.com", "pattern": "^[^\\s@]+@[^\\s@]+.[^\\s@]+$" }, "brand_website": { "type": "string", "description": "Brand website URL", "example": "https://www.example.com", "pattern": "^(http|https)://.*$" }, "phone": { "type": "string", "description": "Phone number in E.164 format", "example": "+12025551234", "pattern": "^\\+[1-9]\\d{1,14}$" } }, "required": [ "email", "first_name", "last_name" ] }, "RCSAgentCarrierRequirementsV2": { "type": "object", "properties": { "version": { "type": "string", "description": "Carrier requirements schema version", "example": "v2" }, "points_of_contact": { "type": "array", "items": { "$ref": "#/components/schemas/RCSAgentPointOfContactV2" }, "maxItems": 5, "minItems": 0 }, "agent_preview": { "$ref": "#/components/schemas/RCSAgentAgentPreviewV2" }, "consent_management": { "$ref": "#/components/schemas/RCSAgentConsentManagementV2" }, "engagement_flows": { "$ref": "#/components/schemas/RCSAgentEngagementFlowsV2" }, "agent_summary": { "$ref": "#/components/schemas/RCSAgentAgentSummaryV2" }, "current_traffic": { "$ref": "#/components/schemas/RCSAgentCurrentTrafficV2" } }, "required": [ "agent_preview", "consent_management", "engagement_flows", "version" ] }, "RCSAgentPointOfContactV2": { "type": "object", "properties": { "first_name": { "type": "string", "description": "The first name of the point of contact for the RCS Agent.", "example": "John", "maxLength": 200, "minLength": 0 }, "last_name": { "type": "string", "description": "The last name of the point of contact for the RCS Agent.", "example": "Doe", "maxLength": 200, "minLength": 0 }, "job_title": { "type": "string", "description": "The job title of the point of contact for the RCS Agent.", "example": "Head of Messaging", "maxLength": 200, "minLength": 0 }, "email": { "type": "string", "description": "The email address of the point of contact for the RCS Agent.", "example": "john.doe@example.com", "pattern": "^[^\\s@]+@[^\\s@]+.[^\\s@]+$" }, "phone": { "type": "string", "description": "The phone number of the point of contact for the RCS Agent.", "example": "+12025551234" } }, "required": [ "email", "first_name", "job_title", "last_name" ] }, "RCSAgentAgentPreviewV2": { "type": "object", "properties": { "agent_access_instructions": { "type": "string", "description": "Instructions for reviewers on how to access and test the agent", "example": "Visit https://example.com/rcs-agent and follow the onboarding flow.", "maxLength": 10000, "minLength": 0 }, "urls": { "type": "array", "description": "List of media URLs showcasing the agent (up to 10)", "items": { "$ref": "#/components/schemas/RCSAgentAgentPreviewLinkV2" }, "maxItems": 10, "minItems": 0 }, "rcs_agent_discovery_methods": { "$ref": "#/components/schemas/RCSAgentAgentDiscoveryMethodsV2" } }, "required": [ "agent_access_instructions" ] }, "RCSAgentAgentPreviewLinkV2": { "type": "object", "properties": { "media_type": { "type": "string", "description": "Media type of the preview asset", "enum": [ "image", "video" ], "example": "image" }, "url": { "type": "string", "description": "URL of the preview asset", "example": "https://cdn.example.com/preview.png", "pattern": "^(http|https)://.*\\.(jpeg|jpg|png)$" } }, "required": [ "media_type", "url" ] }, "RCSAgentAgentDiscoveryMethodsV2": { "type": "object", "properties": { "selection": { "type": "array", "description": "Methods through which users discover the RCS agent", "example": [ "QR_CODE_SCANNING", "WEBSITE_INTEGRATION" ], "items": { "type": "string" }, "minItems": 1 }, "other_input": { "type": "string", "description": "Additional details when OTHER is selected", "example": "Promoted via in-store QR codes", "maxLength": 500, "minLength": 0 } }, "required": [ "selection" ] }, "RCSAgentConsentManagementV2": { "type": "object", "properties": { "user_messaging_consent_methods": { "$ref": "#/components/schemas/RCSAgentUserMessagingConsentMethodsV2" }, "users_opt_in_process": { "$ref": "#/components/schemas/RCSAgentUsersOptInProcessV2" }, "first_opt_in_message": { "type": "string", "description": "The first message sent to users after opting in", "example": "Welcome! You have successfully opted in to receive updates from Acme Bank.", "maxLength": 1000, "minLength": 0 }, "users_opt_out_methods": { "$ref": "#/components/schemas/RCSAgentUsersOptOutMethodsV2" }, "opt_out_processing_time": { "$ref": "#/components/schemas/RCSAgentOptOutProcessingTimeV2" }, "opt_out_confirmation_message": { "$ref": "#/components/schemas/RCSAgentOptOutConfirmationMessageV2" }, "cta_language": { "type": "string", "description": "Call-to-action language used in consent flows", "example": "Reply YES to receive exclusive offers from Acme Bank.", "maxLength": 2000, "minLength": 1 } }, "required": [ "first_opt_in_message", "opt_out_confirmation_message", "opt_out_processing_time", "user_messaging_consent_methods", "users_opt_in_process", "users_opt_out_methods" ] }, "RCSAgentUserMessagingConsentMethodsV2": { "type": "object", "properties": { "selection": { "type": "array", "description": "Selected consent methods", "example": [ "BY_CREATING_ACCOUNT", "BY_MAKING_PURCHASE" ], "items": { "type": "string" }, "minItems": 1 }, "other_input": { "type": "string", "description": "Additional details when `OTHER` is selected", "example": "Users consent via in-store sign-up forms", "maxLength": 500, "minLength": 0 } }, "required": [ "selection" ] }, "RCSAgentUsersOptInProcessV2": { "type": "object", "properties": { "selection": { "type": "array", "description": "Selected opt-in methods", "example": [ "WEBSITE_URL" ], "items": { "type": "string" }, "minItems": 1 }, "links": { "type": "array", "description": "URLs where users can opt in (up to 10)", "example": [ "https://www.example.com/subscribe" ], "items": { "type": "string", "pattern": "^(http|https)://.*$", "example": "https://www.example.com/subscribe", "description": "URL where users can opt in" }, "maxItems": 10, "minItems": 0 } }, "required": [ "selection" ] }, "RCSAgentUsersOptOutMethodsV2": { "type": "object", "properties": { "selection": { "type": "array", "description": "Selected opt-out methods", "example": [ "BY_STOP_OR_UNSUBSCRIBE_MESSAGE" ], "items": { "type": "string" }, "minItems": 1 }, "other_input": { "type": "string", "description": "Additional details when `OTHER` is selected", "example": "Users can opt out via the account settings page", "maxLength": 500, "minLength": 0 } }, "required": [ "selection" ] }, "RCSAgentOptOutProcessingTimeV2": { "type": "object", "properties": { "selection": { "type": "string", "description": "How quickly opt-out requests are processed", "enum": [ "WITHIN_5_MINUTES", "WITHIN_24_HOURS", "OTHER" ], "example": "WITHIN_5_MINUTES" }, "other_input": { "type": "string", "description": "Additional details when OTHER is selected", "example": "Processed within 2 business days", "maxLength": 500, "minLength": 0 } }, "required": [ "selection" ] }, "RCSAgentOptOutConfirmationMessageV2": { "type": "object", "properties": { "selection": { "type": "string", "description": "Confirmation message template sent after opt-out", "enum": [ "SUCCESSFULLY_UNSUBSCRIBED", "WONT_RECEIVE_FURTHER_MESSAGES", "OPT_OUT_REQUEST_PROCESSED", "REPLY_START_TO_RESUBSCRIBE", "OPT_OUT_CONFIRMED", "OTHER" ], "example": "SUCCESSFULLY_UNSUBSCRIBED" }, "other_input": { "type": "string", "description": "Additional details when OTHER is selected", "example": "You have been unsubscribed. Contact support@example.com to resubscribe.", "maxLength": 500, "minLength": 0 } }, "required": [ "selection" ] }, "RCSAgentEngagementFlowsV2": { "type": "object", "properties": { "agent_description": { "type": "string", "description": "Description of what the agent does and how it engages with users", "example": "Acme Bank RCS agent helps customers check balances, receive transaction alerts, and manage payments.", "maxLength": 5000, "minLength": 0 }, "reasons_messages_sent": { "$ref": "#/components/schemas/RCSAgentReasonsMessagesSentV2", "description": "Reasons why messages are sent to users" }, "monthly_user_message_count": { "type": "string", "description": "Estimated number of messages sent to each user per month", "enum": [ "ONE_TWO_MESSAGES", "THREE_FIVE_MESSAGES", "SIX_TEN_MESSAGES", "ELEVEN_TWENTY_MESSAGES", "MORE_THAN_TWENTY_ONE_MESSAGES" ], "example": "THREE_FIVE_MESSAGES" }, "rcs_user_interaction_types": { "$ref": "#/components/schemas/RCSAgentRcsUserInteractionTypesV2", "description": "Types of interactions users have with the agent" }, "help_interaction": { "type": "string", "description": "How the agent responds to HELP messages from users", "example": "Reply HELP for assistance or visit https://www.example.com/support", "maxLength": 2000, "minLength": 1 }, "message_samples": { "type": "array", "description": "Sample messages the agent will send to users (3-10 samples required)", "example": [ "Welcome to AcmeBank alerts. Reply HELP for assistance." ], "items": { "type": "string", "description": "Sample message content", "example": "Welcome to AcmeBank alerts. Reply HELP for assistance.", "maxLength": 2000, "minLength": 1 }, "maxItems": 10, "minItems": 3 }, "message_type": { "type": "string", "description": "Type of RCS messages the agent sends. Use RICH_TEXT or RICH_MEDIA for US carriers; BASIC or SINGLE for non-US carriers.", "enum": [ "RICH_TEXT", "RICH_MEDIA", "BASIC", "SINGLE" ], "example": "RICH_MEDIA" } }, "required": [ "agent_description", "monthly_user_message_count", "rcs_user_interaction_types", "reasons_messages_sent" ] }, "RCSAgentReasonsMessagesSentV2": { "type": "object", "properties": { "selection": { "type": "array", "description": "Selected reasons for sending messages", "example": [ "ORDER_CONFIRMATION", "PAYMENT_REMINDERS" ], "items": { "type": "string" }, "minItems": 1 }, "other_input": { "type": "string", "description": "Additional details when OTHER is selected", "example": "Sending loyalty program milestone notifications", "maxLength": 500, "minLength": 0 } }, "required": [ "selection" ] }, "RCSAgentRcsUserInteractionTypesV2": { "type": "object", "properties": { "selection": { "type": "array", "description": "Selected types of RCS user interactions", "example": [ "SIMPLE_REPLIES", "BUTTON_CLICKS" ], "items": { "type": "string" }, "minItems": 1 }, "other_input": { "type": "string", "description": "Additional details when OTHER is selected", "example": "Users interact via custom carousels", "maxLength": 500, "minLength": 0 } }, "required": [ "selection" ] }, "RCSAgentAgentSummaryV2": { "type": "object", "properties": { "program_summary": { "type": "string", "description": "Summary of the agent messaging program and its intended use", "example": "Acme Bank sends transactional alerts and OTP messages to account holders who have opted in.", "maxLength": 2000, "minLength": 1 } } }, "RCSAgentCurrentTrafficV2": { "type": "object", "properties": { "organic_website_traffic": { "$ref": "#/components/schemas/RCSAgentTrafficRangeV2", "description": "Current organic website traffic range" }, "existing_shortcode_traffic": { "type": "boolean", "description": "Whether the brand currently uses a shortcode for messaging", "example": true }, "shortcode_monthly_traffic": { "$ref": "#/components/schemas/RCSAgentTrafficRangeV2", "description": "Monthly traffic volume range for the existing shortcode" }, "shortcode": { "type": "string", "description": "Existing shortcode number", "example": 12345, "maxLength": 50, "minLength": 0 } } }, "RCSAgentTrafficRangeV2": { "type": "object", "properties": { "min": { "type": "integer", "format": "int64" }, "max": { "type": "integer", "format": "int64" } } }, "RCSAgentBrandDetailsV2": { "type": "object", "properties": { "organization_name": { "type": "string", "maxLength": 255, "minLength": 0 }, "legal_form": { "type": "string", "maxLength": 50, "minLength": 0 }, "stock_symbol": { "type": "string", "maxLength": 12, "minLength": 0 }, "legal_entity_type": { "type": "string", "maxLength": 50, "minLength": 0 }, "country_of_registration": { "type": "string", "maxLength": 2, "minLength": 2, "pattern": "^[A-Z]{2}$" }, "federal_tax_id": { "type": "string", "maxLength": 50, "minLength": 0 }, "business_website_url": { "type": "string", "maxLength": 255, "minLength": 0 }, "address_line1": { "type": "string", "maxLength": 255, "minLength": 0 }, "address_line2": { "type": "string", "maxLength": 255, "minLength": 0 }, "city": { "type": "string", "maxLength": 100, "minLength": 0 }, "state_or_province": { "type": "string", "maxLength": 100, "minLength": 0 }, "zip_or_post_code": { "type": "string", "maxLength": 15, "minLength": 0 } }, "required": [ "address_line1", "business_website_url", "city", "country_of_registration", "legal_entity_type", "legal_form", "organization_name", "state_or_province", "zip_or_post_code" ] }, "RCSAgentTestDeviceV2": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$", "description": "Unique test device identifier", "example": "0198ecd4-da21-7f8b-91d8-ccfbaec485a7" }, "phone": { "type": "string", "description": "Phone number of the test device in E.164 format", "example": "+12025551234", "pattern": "^\\+[1-9]\\d{1,14}$" }, "created_at": { "type": "string", "description": "Date and time when the test device was added" }, "status": { "type": "string", "description": "Status of the test device registration", "example": "ACTIVE" } }, "required": [ "created_at", "id", "phone", "status" ] }, "RCSAgentPublicCarrierStatusV2": { "type": "object", "properties": { "id": { "type": "string", "description": "Carrier identifier", "example": "google-us-att" }, "launch_state": { "type": "string", "description": "Current launch state for this carrier", "enum": [ "LAUNCH_STATE_UNSPECIFIED", "LAUNCH_STATE_UNLAUNCHED", "LAUNCH_STATE_PENDING", "LAUNCH_STATE_LAUNCHED", "LAUNCH_STATE_REJECTED", "LAUNCH_STATE_SUSPENDED", "LAUNCH_STATE_PENDING_UNLAUNCH", "LAUNCH_STATE_INVALID_IN_GMB" ] }, "update_time": { "type": "string", "description": "Date and time of the last status update" }, "launch_submitted_at": { "type": "string", "description": "Date and time when the launch was submitted for this carrier" }, "comment": { "type": "string", "description": "Comment or reason associated with the current launch state" } }, "required": [ "id" ] }, "RCSAgentVerificationDetailsV2": { "type": "object", "properties": { "status": { "type": "string", "description": "Verification status of the agent", "enum": [ "VERIFICATION_STATE_UNSPECIFIED", "VERIFICATION_STATE_UNVERIFIED", "VERIFICATION_STATE_PENDING", "VERIFICATION_STATE_VERIFIED" ], "example": "VERIFICATION_STATE_VERIFIED" } } }, "ErrorResponse": { "type": "object", "description": "Base error response following RFC 7807", "required": [ "type", "title", "instance" ], "properties": { "type": { "type": "string", "description": "Link to error / remediation options", "example": "https://developer.vonage.com/api-errors" }, "title": { "type": "string", "description": "Generic error message", "example": "An error occurred" }, "detail": { "type": "string", "description": "Additional information about the error", "example": "More details about what went wrong" }, "instance": { "type": "string", "description": "Internal Trace ID", "example": "bf0ca0bf927b3b52e3cb03217e1a1ddf" } } }, "PageNumber": { "type": "integer", "description": "The current page", "default": 1, "minimum": 1, "example": 1 }, "PageSize": { "type": "integer", "description": "The size of the page", "default": 10, "minimum": 1, "example": 20 }, "TotalPages": { "type": "integer", "description": "Total number of pages", "minimum": 1, "example": 42 }, "TotalItems": { "type": "integer", "description": "The total number of items in the resource list", "minimum": 0, "example": 871 }, "HalLink": { "type": "object", "description": "A single HAL link object", "required": [ "href" ], "properties": { "href": { "type": "string", "description": "The URL for the resource", "example": "https://api.vonage.com/v1/resources/abc123" }, "templated": { "type": "boolean", "description": "Indicates if the href is a URI template", "example": false }, "type": { "type": "string", "description": "Media type hint for the target resource", "example": "application/json" }, "name": { "type": "string", "description": "Secondary key for selecting link objects", "example": "resource-name" }, "title": { "type": "string", "description": "Human-readable title for the link", "example": "Resource Title" } } }, "PaginationLinks": { "type": "object", "description": "HAL links for page-based paginated collections", "required": [ "self", "first" ], "properties": { "self": { "$ref": "#/components/schemas/HalLink" }, "first": { "allOf": [ { "$ref": "#/components/schemas/HalLink" }, { "description": "Link to the first page" } ] }, "prev": { "allOf": [ { "$ref": "#/components/schemas/HalLink" }, { "description": "Link to the previous page" } ] }, "next": { "allOf": [ { "$ref": "#/components/schemas/HalLink" }, { "description": "Link to the next page" } ] }, "last": { "allOf": [ { "$ref": "#/components/schemas/HalLink" }, { "description": "Link to the last page" } ] } } }, "ErrorResponseWithInvalidParameters": { "allOf": [ { "$ref": "#/components/schemas/ErrorResponse" }, { "type": "object", "required": [ "detail" ], "properties": { "invalid_parameters": { "type": "array", "description": "List of invalid parameters", "items": { "type": "object", "required": [ "name", "reason" ], "properties": { "name": { "type": "string", "description": "Name of the invalid parameter", "example": "name" }, "reason": { "type": "string", "description": "Reason why the parameter is invalid", "example": "Must not be empty" } } } } } } ] }, "SelfLink": { "type": "object", "description": "Link to the current resource (always required in HAL)", "required": [ "self" ], "properties": { "self": { "$ref": "#/components/schemas/HalLink" } } }, "PhoneNumber": { "type": "string", "format": "e164", "pattern": "^[1-9]\\d{1,14}$", "description": "E.164 formatted phone number without + prefix", "example": "447700900001" } }, "headers": { "X-Request-Id": { "description": "A unique identifier for the request, used for tracking and debugging", "schema": { "type": "string", "format": "uuid", "example": "f94b4e56-604e-07e5-e5ad-5a7228618f81" } }, "X-RateLimit-Limit": { "description": "Request limit per hour", "schema": { "type": "integer", "example": 30 } }, "X-RateLimit-Remaining": { "description": "Remaining requests", "schema": { "type": "integer", "example": 5 } }, "X-RateLimit-Reset": { "description": "Unix timestamp when limit resets", "schema": { "type": "integer", "example": 1769182705723 } }, "Retry-After": { "description": "Seconds until next request allowed", "schema": { "type": "integer", "example": 15 } } } }, "tags": [ { "name": "WhatsApp WABAs", "description": "API endpoints relating to working with WhatsApp Business Accounts (WABAs)" }, { "name": "WhatsApp Hosted ES Flow", "description": "API endpoints relating to working with WhatsApp Hosted Embedded Sign-up Flows" }, { "name": "WhatsApp Analytics", "description": "API endpoints relating to analytics data for WhatsApp" }, { "name": "WhatsApp Notification Subscriptions", "description": "API endpoints relating to subscriptions for WhatsApp Notification" }, { "name": "RCS Capability Checks", "description": "API endpoints relating to checking RCS capabilities of a device or devices" }, { "name": "RCS Opt-out Management", "description": "API endpoints relating to managing RCS opt-outs" }, { "name": "RCS Brand Management", "description": "API endpoints relating to managing RCS Brands" }, { "name": "RCS Agent Management", "description": "API endpoints relating to managing RCS Agents" }, { "name": "RCS Deeplinks", "description": "API endpoints relating to generating RCS Deeplinks" } ] }