Query structured spec data via REST or MCP. Get exactly what your agent needs.
https://dev.dixa.io
/v1/agents
Lists all agents/admins in an organization. It is possible to filter by one of the mutually exclusive parameters: email or phone number. In case both are provided, an error is returned.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| pageLimit | query | optional | integer | Maximum number of results per page. May be used in combination with pageKey to change the number of results in between page requests. |
| pageKey | query | optional | string | Base64 encoded form of pagination query parameters. Do not try to construct or change programmatically as the internal structure may change without notice. |
| query | optional | string | The agent/admin email filter |
|
| phone | query | optional | string | The agent/admin phone number filter |
The list of agents/admins
Invalid value extracted from request context, Invalid value for: query parameter pageLimit, Invalid value for: query parameter pageKey, Invalid value for: query parameter email, Invalid value for: query parameter phone, Duplicate phone number, Duplicate email address, Invalid filters: Cannot provide both phone number and email address
An entity in this request could not be found
Internal failure during request processing
GET /v1/agents
/v1/agents/presence
List the presence status for all agents/admins in an organization.
The list of presence status for all agents/admins
Invalid value extracted from request context
Internal failure during request processing
GET /v1/agents/presence
/v1/agents/{agentId}
Get an agent/admin by id.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| agentId | path | required | string | The agent/admin id |
The agent/admin
Invalid value for: path parameter agentId, Invalid value extracted from request context
An entity in this request could not be found
Internal failure during request processing
GET /v1/agents/{agentId}
/v1/agents/{agentId}/presence
Get the presence status for an agent/admin.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| agentId | path | required | string | The agent/admin id |
The agent/admin presence status
Invalid value for: path parameter agentId, Invalid value extracted from request context
An entity in this request could not be found
Internal failure during request processing
GET /v1/agents/{agentId}/presence
/v1/agents/{agentId}/teams
List the teams in which the agent/admin is a member.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| agentId | path | required | string | The agent/admin id |
The list of teams in which the agent/admin is a member
Invalid value for: path parameter agentId, Invalid value extracted from request context
An entity in this request could not be found
Internal failure during request processing
GET /v1/agents/{agentId}/teams
/v1/analytics/filter/{filterAttribute}
Get possible values to be used with a given filter attribute. Filter attributes are not metric or record specific, so one filter attribute can be used with multiple metrics/records. When a filter value is not relevant for a specific metric/record, it is simply ignored.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| filterAttribute | path | required | string | — |
| pageLimit | query | optional | integer | Maximum number of results per page. May be used in combination with pageKey to change the number of results in between page requests. |
| pageKey | query | optional | string | Base64 encoded form of pagination query parameters. Do not try to construct or change programmatically as the internal structure may change without notice. |
The possible filter values to be used when fetching metrics or records
Invalid value extracted from request context, Invalid value for: query parameter pageLimit, Invalid value for: query parameter pageKey
Internal Server Error
GET /v1/analytics/filter/{filterAttribute}
/v1/analytics/metrics
This endpoint lists all available metric IDs that can be used to fetch data in Get Metric Data
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| pageLimit | query | optional | integer | Maximum number of results per page. May be used in combination with pageKey to change the number of results in between page requests. |
| pageKey | query | optional | string | Base64 encoded form of pagination query parameters. Do not try to construct or change programmatically as the internal structure may change without notice. |
The catalogue of metrics
Invalid value extracted from request context, Invalid value for: query parameter pageLimit, Invalid value for: query parameter pageKey
Internal Server Error
GET /v1/analytics/metrics
/v1/analytics/metrics/{metricId}
This endpoint lists all available properties of a metric to use for querying its data
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| metricId | path | required | string | — |
The metric properties
Invalid value extracted from request context
Internal Server Error
GET /v1/analytics/metrics/{metricId}
/v1/analytics/records
This endpoint lists all available record IDs that can be used to fetch data in Get Metric Records Data
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| pageLimit | query | optional | integer | Maximum number of results per page. May be used in combination with pageKey to change the number of results in between page requests. |
| pageKey | query | optional | string | Base64 encoded form of pagination query parameters. Do not try to construct or change programmatically as the internal structure may change without notice. |
The catalogue of metric records
Invalid value extracted from request context, Invalid value for: query parameter pageLimit, Invalid value for: query parameter pageKey
Internal Server Error
GET /v1/analytics/records
/v1/analytics/records/{recordId}
This endpoint lists all available properties of a record to use for querying its data
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| recordId | path | required | string | — |
The metric record properties
Invalid value extracted from request context
Internal Server Error
GET /v1/analytics/records/{recordId}
/v1/anonymization/request/{requestId}
Retrieve an anonymization request submitted earlier (user or conversation).
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| requestId | path | required | string | — |
The anonymization request
Invalid value for: path parameter requestId, Invalid value extracted from request context
The user who issued the access token used in the request is not authorized to perform the operation
An entity in this request could not be found
Internal failure during request processing
GET /v1/anonymization/request/{requestId}
/v1/contact-endpoints
List all available contact endpoints in an organization.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| _type | query | optional | string | An optional contact type can be specified to filter the contact endpoints. If not provided, all types are listed. Possible values: [EmailEndpoint, TelephonyEndpoint] |
The list of available contact endpoints
Invalid value extracted from request context, Invalid value for: query parameter _type
Internal failure during request processing
GET /v1/contact-endpoints
/v1/contact-endpoints/{contactEndpointId}
Get contact endpoint by id (email or phone number).
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| contactEndpointId | path | required | string | — |
The requested contact endpoint
Invalid value extracted from request context, The contactEndpointId is neither a valid email nor a valid E.164 phone number
An entity in this request could not be found
GET /v1/contact-endpoints/{contactEndpointId}
/v1/conversations/activitylog
List all activity logs for an organization.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| pageLimit | query | optional | integer | Maximum number of results per page. May be used in combination with pageKey to change the number of results in between page requests. |
| pageKey | query | optional | string | Base64 encoded form of pagination query parameters. Do not try to construct or change programmatically as the internal structure may change without notice. |
| fromDatetime | query | optional | string | Starting date-time filter with ISO 8601 format: yyyy-MM-dd’T’HH:mm:sss’Z’ |
| toDatetime | query | optional | string | Ending date-time filter with ISO 8601 format: yyyy-MM-dd’T’HH:mm:sss’Z’ |
The full list of activity logs for an organization with pagination
Invalid value extracted from request context, Invalid value for: query parameter pageLimit, Invalid value for: query parameter pageKey, Invalid value for: query parameter fromDatetime, Invalid value for: query parameter toDatetime, Validation failure when retrieving data
Internal failure during request processing
GET /v1/conversations/activitylog
/v1/conversations/flows
List all conversations flows in an organization.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| channel | query | optional | string | An optional ConversationChannel can be specified to filter the flows. If not provided, the default channel is PstnPhone. Possible values: [WhatsApp, Voicemail, WidgetChat, FacebookMessenger, Email, ContactForm, Callback, PstnPhone, Messenger] |
The list of conversation flows
Invalid value extracted from request context, Invalid value for: query parameter channel
Internal failure during request processing
GET /v1/conversations/flows
/v1/conversations/{conversationId}
Get a conversation by id.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| conversationId | path | required | integer | — |
The conversation
Invalid value for: path parameter conversationId, Invalid value extracted from request context
An entity in this request could not be found
Internal failure during request processing
GET /v1/conversations/{conversationId}
/v1/conversations/{conversationId}/activitylog
Get the activity log for a conversation by providing the conversation id.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| conversationId | path | required | integer | — |
Activity log entries for a conversation
Invalid value for: path parameter conversationId, Invalid value extracted from request context
Internal failure during request processing
GET /v1/conversations/{conversationId}/activitylog
/v1/conversations/{conversationId}/linked
Lists all linked child conversations for the given conversation ID, such as transcripts and side conversations.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| conversationId | path | required | integer | — |
The list of conversations requested by an EndUser
Invalid value for: path parameter conversationId, Invalid value extracted from request context
An entity in this request could not be found
Internal failure during request processing
GET /v1/conversations/{conversationId}/linked
/v1/conversations/{conversationId}/notes
Get all internal notes for a particular conversation by providing the conversation id.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| conversationId | path | required | integer | — |
List of internal notes for a conversation sorted from oldest to newest
Invalid value for: path parameter conversationId, Invalid value extracted from request context
An entity in this request could not be found
Internal failure during request processing
GET /v1/conversations/{conversationId}/notes
/v1/conversations/{conversationId}/messages
Get all messages for a particular conversation by providing the conversation id. Note that messages in ContactForm conversations can have attributes of "_type": "EmailAttributes" if they are created through a webform, or "_type": "ContactFormAttributes" when created through a chat widget.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| conversationId | path | required | integer | — |
List of messages for a conversation sorted from oldest to newest
Invalid value for: path parameter conversationId, Invalid value extracted from request context
An entity in this request could not be found
GET /v1/conversations/{conversationId}/messages
/v1/conversations/{conversationId}/rating
Get the ratings for a particular conversation by providing the conversation id.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| conversationId | path | required | integer | — |
List of ratings for a conversation
Invalid value for: path parameter conversationId, Invalid value extracted from request context
An entity in this request could not be found
Internal failure during request processing
GET /v1/conversations/{conversationId}/rating
/v1/conversations/{conversationId}/tags
Get the tags for a particular conversation by providing the conversation id.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| conversationId | path | required | integer | — |
List of tags for a conversation
Invalid value for: path parameter conversationId, Invalid value extracted from request context
An entity in this request could not be found
Internal failure during request processing
GET /v1/conversations/{conversationId}/tags
/v1/custom-attributes
List all custom attributes in an organization.
The list of configured custom attributes
Invalid value extracted from request context
Internal failure during request processing
GET /v1/custom-attributes
/v1/endusers
Lists all end users in an organization. It is possible to filter by one of the mutually exclusive parameters: email or phone number. In case both are provided, an error is returned.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| pageLimit | query | optional | integer | Maximum number of results per page. May be used in combination with pageKey to change the number of results in between page requests. |
| pageKey | query | optional | string | Base64 encoded form of pagination query parameters. Do not try to construct or change programmatically as the internal structure may change without notice. |
| query | optional | string | Filter by the contact’s email |
|
| phone | query | optional | string | Filter by the contact’s phone number |
| externalId | query | optional | string | Filter by the contact’s external id |
The list of end users
Invalid value extracted from request context, Invalid value for: query parameter pageLimit, Invalid value for: query parameter pageKey, Invalid value for: query parameter email, Invalid value for: query parameter phone, Invalid value for: query parameter externalId, Duplicate phone number, Duplicate email address, Invalid filters: Cannot provide more than one filter
An entity in this request could not be found
Internal failure during request processing
GET /v1/endusers
/v1/endusers/{userId}
Get an end user by id.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| userId | path | required | string | The end user id |
The end user
Invalid value for: path parameter userId, Invalid value extracted from request context
An entity in this request could not be found
Internal failure during request processing
GET /v1/endusers/{userId}
/v1/endusers/{userId}/conversations
Lists conversations requested by an end user.
Note: Custom attributes are not part of the response at this point. If you need to get custom attributes for a conversation use the GET /conversations/{conversationId} endpoint
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| userId | path | required | string | — |
| pageLimit | query | optional | integer | Maximum number of results per page. May be used in combination with pageKey to change the number of results in between page requests. |
| pageKey | query | optional | string | Base64 encoded form of pagination query parameters. Do not try to construct or change programmatically as the internal structure may change without notice. |
The list of conversations requested by an EndUser
Invalid value for: path parameter userId, Invalid value extracted from request context, Invalid value for: query parameter pageLimit, Invalid value for: query parameter pageKey
An entity in this request could not be found
Internal failure during request processing
GET /v1/endusers/{userId}/conversations
/v1/queues
List all queues in an organization.
The list of queues in an organization
Invalid value extracted from request context
Internal failure during request processing
GET /v1/queues
/v1/queues/{queueId}
Get a queue by id.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| queueId | path | required | string | — |
The queue
Invalid value for: path parameter queueId, Invalid value extracted from request context
An entity in this request could not be found
Internal failure during request processing
GET /v1/queues/{queueId}
/v1/queues/{queueId}/members
List all agents/admins that are members of a queue by providing the queue id.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| queueId | path | required | string | — |
List of the agents/admins that are members of a queue
Invalid value for: path parameter queueId, Invalid value extracted from request context
An entity in this request could not be found
Internal failure during request processing
GET /v1/queues/{queueId}/members
/v1/search/conversations
Search for conversations containing a particular text.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| pageLimit | query | optional | integer | Maximum number of results per page. May be used in combination with pageKey to change the number of results in between page requests. |
| pageKey | query | optional | string | Base64 encoded form of pagination query parameters. Do not try to construct or change programmatically as the internal structure may change without notice. |
| query | query | required | string | The text by which to search conversations |
| exactMatch | query | optional | boolean | Return only exact matches. This value is false by default. |
The search results for the searched parameters
Invalid value extracted from request context, Invalid value for: query parameter pageLimit, Invalid value for: query parameter pageKey, Invalid value for: query parameter query, Invalid value for: query parameter exactMatch
The user who issued the access token used in the request is not authorized to perform the operation
Internal failure during request processing
GET /v1/search/conversations
/v1/tags
List all tags in an organization.
The list of tags in an organization
Invalid value extracted from request context
Internal failure during request processing
GET /v1/tags
/v1/tags/{tagId}
Get a tag by id.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| tagId | path | required | string | — |
The tag
Invalid value for: path parameter tagId, Invalid value extracted from request context
An entity in this request could not be found
Internal failure during request processing
GET /v1/tags/{tagId}
/v1/teams
Lists all teams in an organization.
The list of teams in an organization
Invalid value extracted from request context
Internal failure during request processing
GET /v1/teams
/v1/teams/{teamId}
Get a team by id.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| teamId | path | required | string | The team id |
The team
Invalid value for: path parameter teamId, Invalid value extracted from request context
An entity in this request could not be found
GET /v1/teams/{teamId}
/v1/teams/{teamId}/agents
Lists all agents/admins in a team.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| teamId | path | required | string | The team id |
List of agents/admins in the specified team
Invalid value for: path parameter teamId, Invalid value extracted from request context
Internal failure during request processing
GET /v1/teams/{teamId}/agents
/v1/teams/{teamId}/presence
List the presence status of all agents/admins in a team.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| teamId | path | required | string | The team id |
| pageLimit | query | optional | integer | Maximum number of results per page. May be used in combination with pageKey to change the number of results in between page requests. |
| pageKey | query | optional | string | Base64 encoded form of pagination query parameters. Do not try to construct or change programmatically as the internal structure may change without notice. |
List of agents/admins presence status in the specified team
Invalid value for: path parameter teamId, Invalid value extracted from request context, Invalid value for: query parameter pageLimit, Invalid value for: query parameter pageKey
An entity in this request could not be found
Internal failure during request processing
GET /v1/teams/{teamId}/presence
/v1/webhooks
List of all Webhook Subscriptions in an organization.
The List of Webhook Subscriptions
Invalid value extracted from request context
Internal Server Error
GET /v1/webhooks
/v1/webhooks/{webhookSubscriptionId}
Get a Webhook Subscription by ID.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| webhookSubscriptionId | path | required | string | — |
The Webhook Subscription
Invalid value for: path parameter webhookSubscriptionId, Invalid value extracted from request context
An entity in this request could not be found
Internal Server Error
GET /v1/webhooks/{webhookSubscriptionId}
/v1/webhooks/{webhookSubscriptionId}/delivery-status
Get the latest delivery statuses of a Webhook Subscription.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| webhookSubscriptionId | path | required | string | — |
The Latest Delivery Statuses of a Webhook Subscription
Invalid value for: path parameter webhookSubscriptionId, Invalid value extracted from request context
An entity in this request could not be found
Internal Server Error
GET /v1/webhooks/{webhookSubscriptionId}/delivery-status
/v1/webhooks/{webhookSubscriptionId}/delivery-status/logs/{event}
Get the latest Webhook Subscription Event logs.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| webhookSubscriptionId | path | required | string | — |
| event | path | required | string | — |
The Webhook Subscription Event Logs
Invalid value for: path parameter webhookSubscriptionId, Invalid value extracted from request context
An entity in this request could not be found
Internal Server Error
GET /v1/webhooks/{webhookSubscriptionId}/delivery-status/logs/{event}
ActivityLogAttribute
{
"oneOf": [
{
"$ref": "#/components/schemas/ConversationAssignedAttribute"
},
{
"$ref": "#/components/schemas/ConversationAutoReplySentAttribute"
},
{
"$ref": "#/components/schemas/ConversationClaimedAttribute"
},
{
"$ref": "#/components/schemas/ConversationCreatedAttribute"
},
{
"$ref": "#/components/schemas/ConversationEndUserReplacedAttribute"
},
{
"$ref": "#/components/schemas/ConversationLanguageUpdatedAttribute"
},
{
"$ref": "#/components/schemas/ConversationOfferedAttribute"
},
{
"$ref": "#/components/schemas/ConversationRatedAttribute"
},
{
"$ref": "#/components/schemas/ConversationRatingOfferedAttribute"
},
{
"$ref": "#/components/schemas/ConversationRatingScheduledAttribute"
},
{
"$ref": "#/components/schemas/ConversationReservedAttribute"
},
{
"$ref": "#/components/schemas/ConversationTransferredAttribute"
},
{
"$ref": "#/components/schemas/ConversationUnassignedAttribute"
},
{
"$ref": "#/components/schemas/MessageAddedAttribute"
},
{
"$ref": "#/components/schemas/NoteAddedAttribute"
},
{
"$ref": "#/components/schemas/TagAddedAttribute"
},
{
"$ref": "#/components/schemas/TagRemovedAttribute"
}
]
}
ActivityLogEntry
{
"type": "object",
"required": [
"id",
"conversationId",
"activityTimestamp",
"activityType",
"_type"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"_type": {
"type": "string",
"description": "values: [ConversationRatingScheduled, ConversationOfferAccepted, ConversationPending, ConversationRatingUnscheduled, ConversationOfferRejected, ConversationEndUserReplaced, NoteAdded, FollowupExpired, ConversationRated, TagAdded, ConversationOfferTimeout, MessageAddedByCustomer, ConversationCreatedByCustomer, ConversationCreatedByAgent, TransferFailed, TransferSuccessful, ConversationOffered, ConversationUnassigned, TagRemoved, TransferInitiated, ConversationClaimed, ConversationReopened, ConversationClosed, ConversationLanguageUpdated, FollowupAdded, ConversationAutoreplySent, ConversationReserved, ConversationAssigned, ConversationRatingOffered, ConversationRatingCancelled, MessageAddedByAgent, FollowupRemoved]"
},
"author": {
"$ref": "#/components/schemas/ActivityLogUser"
},
"attributes": {
"$ref": "#/components/schemas/ActivityLogAttribute"
},
"activityType": {
"$ref": "#/components/schemas/DeprecatedActivityLogType"
},
"conversationId": {
"type": "integer",
"format": "int32"
},
"activityTimestamp": {
"type": "string",
"format": "date-time"
}
}
}
ActivityLogUser
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"email": {
"type": "string"
},
"phoneNumber": {
"type": "string"
}
}
}
Agent
{
"type": "object",
"required": [
"id",
"createdAt",
"displayName",
"email"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "Unique identifier for the agent"
},
"email": {
"type": "string",
"description": "The agent's primary email address"
},
"roles": {
"type": "array",
"items": {
"type": "string",
"description": "values: [Agent, SystemAdmin, TeamLead, Admin]"
},
"description": "The agent's roles"
},
"lastName": {
"type": "string",
"description": "The agent's last name"
},
"avatarUrl": {
"type": "string",
"description": "The url from which to load the agent's avatar"
},
"createdAt": {
"type": "string",
"format": "date-time",
"description": "Time when the agent was created"
},
"firstName": {
"type": "string",
"description": "The agent's first name"
},
"displayName": {
"type": "string",
"description": "The agent's display name"
},
"middleNames": {
"type": "array",
"items": {
"type": "string"
},
"description": "The agent's middle names"
},
"phoneNumber": {
"type": "string",
"description": "The agent's primary phone number"
},
"additionalEmails": {
"type": "array",
"items": {
"type": "string"
},
"description": "Additional email addresses for the agent"
},
"additionalPhoneNumbers": {
"type": "array",
"items": {
"type": "string"
},
"description": "Additional phone numbers for the agent"
}
}
}
AgentOutput
{
"type": "object",
"required": [
"data"
],
"properties": {
"data": {
"$ref": "#/components/schemas/Agent"
}
}
}
AgentTeamsOutput
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Team"
}
}
}
}
AgentsBulkPatchRequest
{
"type": "array",
"items": {
"$ref": "#/components/schemas/BulkPatchAgentInput"
}
}
AgentsListPresenceResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/UserPresence"
}
}
AgentsToTeamInput
{
"type": "object",
"properties": {
"agentIds": {
"type": "array",
"items": {
"type": "string",
"format": "uuid"
}
}
}
}
AgentsUpdateBulkRequest
{
"type": "array",
"items": {
"$ref": "#/components/schemas/BulkUpdateAgentInput"
}
}
AggregateMetadata
{
"type": "object",
"required": [
"measure"
],
"properties": {
"measure": {
"type": "string",
"description": "values: [Min, Max, Sum, Count, Percentage, StdDev, Average]"
},
"description": {
"type": "string"
}
}
}
AggregateValue
{
"oneOf": [
{
"$ref": "#/components/schemas/DoubleAggregateValue"
},
{
"$ref": "#/components/schemas/LongAggregateValue"
}
]
}
AnonymizationRequestStatus
{
"type": "object",
"required": [
"id",
"entityType",
"_type",
"initiatedAt",
"targetEntityId",
"requestedBy"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"_type": {
"type": "string",
"description": "values: [Conversation, Message, User]"
},
"entityType": {
"$ref": "#/components/schemas/DeprecatedAnonymizationType"
},
"initiatedAt": {
"type": "string",
"format": "date-time"
},
"processedAt": {
"type": "string",
"format": "date-time"
},
"requestedBy": {
"type": "string",
"format": "uuid"
},
"targetEntityId": {
"type": "string"
}
}
}
AnonymizeEntityInput
{
"type": "object",
"required": [
"entityId"
],
"properties": {
"_type": {
"type": "string",
"description": "values: [Conversation, Message, User]"
},
"entityId": {
"type": "string"
},
"entityType": {
"$ref": "#/components/schemas/DeprecatedAnonymizationType"
},
"forceAnonymization": {
"type": "boolean"
}
}
}
AnonymizeEntityOutput
{
"type": "object",
"required": [
"data"
],
"properties": {
"data": {
"$ref": "#/components/schemas/AnonymizationRequestStatus"
}
}
}
AnonymizedConversation
{
"type": "object",
"required": [
"id",
"requesterId",
"channel",
"createdAt",
"anonymizedAt"
],
"properties": {
"id": {
"type": "integer",
"format": "int64"
},
"link": {
"$ref": "#/components/schemas/ConversationLink"
},
"state": {
"type": "string",
"description": "values: [AwaitingPending, Closed, Open, Pending]"
},
"channel": {
"type": "string",
"description": "values: [WhatsApp, Voicemail, WidgetChat, FacebookMessenger, Twitter, Email, ContactForm, Callback, PstnPhone, Sms, Messenger]"
},
"createdAt": {
"type": "string",
"format": "date-time"
},
"direction": {
"type": "string",
"description": "values: [Inbound, Internal, Outbound]"
},
"requesterId": {
"type": "string",
"format": "uuid"
},
"anonymizedAt": {
"type": "string",
"format": "date-time"
},
"stateUpdatedAt": {
"type": "string",
"format": "date-time"
},
"customAttributes": {
"type": "array",
"items": {
"$ref": "#/components/schemas/CustomAttribute"
}
}
}
}
Assignment
{
"type": "object",
"required": [
"agentId",
"assignedAt"
],
"properties": {
"agentId": {
"type": "string",
"format": "uuid"
},
"assignedAt": {
"type": "string",
"format": "date-time"
}
}
}
Attributes
{
"oneOf": [
{
"$ref": "#/components/schemas/CallRecordingAttributes"
},
{
"$ref": "#/components/schemas/ChatAttributes"
},
{
"$ref": "#/components/schemas/ContactFormAttributes"
},
{
"$ref": "#/components/schemas/EmailAttributes"
},
{
"$ref": "#/components/schemas/FacebookMessengerAttributes"
},
{
"$ref": "#/components/schemas/GenericAttributes"
},
{
"$ref": "#/components/schemas/PhoneAttributes"
},
{
"$ref": "#/components/schemas/SmsAttributes"
},
{
"$ref": "#/components/schemas/TwitterAttributes"
},
{
"$ref": "#/components/schemas/WhatsAppAttributes"
}
]
}
BadRequest
{
"type": "object",
"required": [
"message"
],
"properties": {
"message": {
"type": "string"
}
}
}
BasicAuth
{
"type": "object",
"required": [
"username",
"password"
],
"properties": {
"password": {
"type": "string"
},
"username": {
"type": "string"
}
}
}
BooleanField
{
"type": "object",
"required": [
"value"
],
"properties": {
"value": {
"type": "boolean"
}
}
}
BrowserInfo
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
},
"version": {
"type": "string"
},
"ipAddress": {
"type": "string"
},
"originatingUrl": {
"type": "string"
}
}
}
BulkActionFailure_BulkError_Agent
{
"type": "object",
"required": [
"error"
],
"properties": {
"error": {
"$ref": "#/components/schemas/BulkError"
}
}
}
BulkActionFailure_BulkError_EndUser
{
"type": "object",
"required": [
"error"
],
"properties": {
"error": {
"$ref": "#/components/schemas/BulkError"
}
}
}
BulkActionFailure_BulkError_UUID
{
"type": "object",
"required": [
"error"
],
"properties": {
"error": {
"$ref": "#/components/schemas/BulkError"
}
}
}
BulkActionFailure_ErrorResponse_InternalNoteData
{
"type": "object",
"required": [
"error"
],
"properties": {
"error": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
BulkActionOutcome_BulkError_Agent
{
"oneOf": [
{
"$ref": "#/components/schemas/BulkActionFailure_BulkError_Agent"
},
{
"$ref": "#/components/schemas/BulkActionSuccess_BulkError_Agent"
}
]
}
BulkActionOutcome_BulkError_EndUser
{
"oneOf": [
{
"$ref": "#/components/schemas/BulkActionFailure_BulkError_EndUser"
},
{
"$ref": "#/components/schemas/BulkActionSuccess_BulkError_EndUser"
}
]
}
BulkActionOutcome_BulkError_UUID
{
"oneOf": [
{
"$ref": "#/components/schemas/BulkActionFailure_BulkError_UUID"
},
{
"$ref": "#/components/schemas/BulkActionSuccess_BulkError_UUID"
}
]
}
BulkActionOutcome_ErrorResponse_InternalNoteData
{
"oneOf": [
{
"$ref": "#/components/schemas/BulkActionFailure_ErrorResponse_InternalNoteData"
},
{
"$ref": "#/components/schemas/BulkActionSuccess_ErrorResponse_InternalNoteData"
}
]
}
BulkActionSuccess_BulkError_Agent
{
"type": "object",
"required": [
"data"
],
"properties": {
"data": {
"$ref": "#/components/schemas/Agent"
}
}
}
BulkActionSuccess_BulkError_EndUser
{
"type": "object",
"required": [
"data"
],
"properties": {
"data": {
"$ref": "#/components/schemas/EndUser"
}
}
}
BulkActionSuccess_BulkError_UUID
{
"type": "object",
"required": [
"data"
],
"properties": {
"data": {
"type": "string",
"format": "uuid"
}
}
}
BulkActionSuccess_ErrorResponse_InternalNoteData
{
"type": "object",
"required": [
"data"
],
"properties": {
"data": {
"$ref": "#/components/schemas/InternalNoteData"
}
}
}
BulkCreateInternalNoteInput
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/CreateInternalNoteInput"
}
}
}
}
BulkCreateNoteOutput
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/BulkActionOutcome_ErrorResponse_InternalNoteData"
}
}
}
}
BulkError
{
"oneOf": [
{
"$ref": "#/components/schemas/EmptyPatchSet"
},
{
"$ref": "#/components/schemas/ErrorResponse"
},
{
"$ref": "#/components/schemas/Infrastructure"
},
{
"$ref": "#/components/schemas/Integrity"
},
{
"$ref": "#/components/schemas/NotFound1"
},
{
"$ref": "#/components/schemas/Validation"
}
]
}
BulkPatchAgentInput
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Unique identifier for the agent"
},
"lastName": {
"type": "string",
"description": "The agent's last name"
},
"avatarUrl": {
"type": "string",
"description": "The url from which to load the agent's avatar"
},
"firstName": {
"type": "string",
"description": "The agent's first name"
},
"displayName": {
"type": "string",
"description": "The agent's display name"
},
"middleNames": {
"type": "array",
"items": {
"type": "string"
},
"description": "The agent's middle names"
},
"phoneNumber": {
"type": "string",
"description": "The agent's primary phone number"
},
"additionalEmails": {
"type": "array",
"items": {
"type": "string"
},
"description": "Additional email addresses for the agent"
},
"additionalPhoneNumbers": {
"type": "array",
"items": {
"type": "string"
},
"description": "Additional phone numbers for the agent"
}
}
}
BulkPatchEndUserInput
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"email": {
"type": "string"
},
"lastName": {
"type": "string"
},
"avatarUrl": {
"type": "string"
},
"firstName": {
"type": "string"
},
"externalId": {
"type": "string"
},
"displayName": {
"type": "string"
},
"middleNames": {
"type": "array",
"items": {
"type": "string"
}
},
"phoneNumber": {
"type": "string"
},
"additionalEmails": {
"type": "array",
"items": {
"type": "string"
}
},
"additionalPhoneNumbers": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
BulkPatchEndUsersInput
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/BulkPatchEndUserInput"
}
}
}
}
BulkPatchEndUsersOutput
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/BulkActionOutcome_BulkError_EndUser"
}
}
}
}
BulkQueueEndpointInput
{
"type": "object",
"properties": {
"agentIds": {
"type": "array",
"items": {
"type": "string",
"format": "uuid"
}
}
}
}
BulkQueueEndpointOutput
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/BulkActionOutcome_BulkError_UUID"
}
}
}
}
BulkUpdateAgentInput
{
"type": "object",
"required": [
"id",
"displayName"
],
"properties": {
"id": {
"type": "string",
"description": "Unique identifier for the agent"
},
"lastName": {
"type": "string",
"description": "The agent's last name"
},
"avatarUrl": {
"type": "string",
"description": "The url from which to load the agent's avatar"
},
"firstName": {
"type": "string",
"description": "The agent's first name"
},
"displayName": {
"type": "string",
"description": "The agent's display name"
},
"middleNames": {
"type": "array",
"items": {
"type": "string"
},
"description": "The agent's middle names"
},
"phoneNumber": {
"type": "string",
"description": "The agent's primary phone number"
},
"additionalEmails": {
"type": "array",
"items": {
"type": "string"
},
"description": "Additional email addresses for the agent"
},
"additionalPhoneNumbers": {
"type": "array",
"items": {
"type": "string"
},
"description": "Additional phone numbers for the agent"
}
}
}
BulkUpdateAgentOutput
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/BulkActionOutcome_BulkError_Agent"
}
}
}
}
BulkUpdateEndUserInput
{
"type": "object",
"required": [
"id",
"displayName"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"email": {
"type": "string"
},
"lastName": {
"type": "string"
},
"avatarUrl": {
"type": "string"
},
"firstName": {
"type": "string"
},
"externalId": {
"type": "string"
},
"displayName": {
"type": "string"
},
"middleNames": {
"type": "array",
"items": {
"type": "string"
}
},
"phoneNumber": {
"type": "string"
},
"additionalEmails": {
"type": "array",
"items": {
"type": "string"
}
},
"additionalPhoneNumbers": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
BulkUpdateEndUsersInput
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/BulkUpdateEndUserInput"
}
}
}
}
BulkUpdateEndUsersOutput
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/BulkActionOutcome_BulkError_EndUser"
}
}
}
}
CallRecordingAttributes
{
"type": "object",
"required": [
"recording"
],
"properties": {
"duration": {
"type": "integer",
"format": "int32"
},
"recording": {
"type": "string"
}
}
}
Callback
{
"type": "object",
"required": [
"requesterId",
"direction",
"contactEndpointId",
"queueId"
],
"properties": {
"queueId": {
"type": "string",
"format": "uuid"
},
"direction": {
"type": "string",
"description": "values: [Inbound, Outbound]"
},
"requesterId": {
"type": "string",
"format": "uuid"
},
"contactEndpointId": {
"type": "string"
}
}
}