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 |
GET /v1/agents
/v1/agents
Bulk patch agents/admins.
{
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/AgentsBulkPatchRequest"
},
"example": [
{
"id": "434ce9f5-14c8-4be1-a0a8-f755010deb9bX",
"displayName": "AB",
"middleNames": [],
"additionalEmails": [],
"additionalPhoneNumbers": []
},
{
"id": "434ce9f5-14c8-4be1-a0a8-f755010deb9c",
"displayName": "JB",
"middleNames": [],
"additionalEmails": [],
"additionalPhoneNumbers": []
}
]
}
},
"required": false,
"description": "List of agent/admin patch actions"
}
PATCH /v1/agents
/v1/agents
Create an agent.
{
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CreateAgentInput"
},
"example": {
"email": "alice@brown.com",
"lastName": "Brown",
"avatarUrl": "http://avatar.url",
"firstName": "Alice",
"displayName": "Alice Brown",
"middleNames": [],
"phoneNumber": "+551155256325",
"additionalEmails": [
"alice@secondary.email"
],
"additionalPhoneNumbers": [
"+5566778899"
]
}
}
},
"required": true,
"description": "The agent's details"
}
POST /v1/agents
/v1/agents
Bulk update agents/admins.
{
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/AgentsUpdateBulkRequest"
},
"example": [
{
"id": "434ce9f5-14c8-4be1-a0a8-f755010deb9b",
"lastName": "Brown",
"avatarUrl": "http://avatar.url",
"firstName": "Alice",
"displayName": "Alice Brown",
"middleNames": [],
"phoneNumber": "+551155256325",
"additionalEmails": [],
"additionalPhoneNumbers": []
}
]
}
},
"required": false,
"description": "The list of agent/admin update actions"
}
PUT /v1/agents
/v1/agents/bulk
Create agents in bulk.
{
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CreateAgentsInput"
},
"example": {
"data": [
{
"email": "alice@brown.com",
"lastName": "Brown",
"avatarUrl": "http://avatar.url",
"firstName": "Alice",
"displayName": "Alice Brown",
"middleNames": [],
"phoneNumber": "+551155256325",
"additionalEmails": [],
"additionalPhoneNumbers": []
}
]
}
}
},
"required": true,
"description": "The list of agent's details"
}
POST /v1/agents/bulk
/v1/agents/presence
List the presence status for all agents/admins in an organization.
GET /v1/agents/presence
/v1/agents/{agentId}
Downgrade an agent/admin to become an end user.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| agentId | path | required | string | The agent/admin id |
DELETE /v1/agents/{agentId}
/v1/agents/{agentId}
Get an agent/admin by id.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| agentId | path | required | string | The agent/admin id |
GET /v1/agents/{agentId}
/v1/agents/{agentId}
Patch an agent/admin.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| agentId | path | required | string | The agent/admin id |
{
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PatchAgentInput"
},
"example": {
"lastName": "Brown",
"avatarUrl": "http://avatar.url",
"firstName": "Alice",
"displayName": "Alice Brown",
"middleNames": [],
"additionalEmails": [],
"additionalPhoneNumbers": []
}
}
},
"required": true,
"description": "The agent/admin patch"
}
PATCH /v1/agents/{agentId}
/v1/agents/{agentId}
Update an agent/admin.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| agentId | path | required | string | The agent id |
{
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/UpdateAgentInput"
},
"example": {
"lastName": "Brown",
"avatarUrl": "http://avatar.url",
"firstName": "Alice",
"displayName": "Alice Brown",
"middleNames": [
"Julia"
],
"phoneNumber": "+551155256325",
"additionalEmails": [],
"additionalPhoneNumbers": []
}
}
},
"required": true,
"description": "The updated details for an agent/admin"
}
PUT /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 |
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 |
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. |
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. |
GET /v1/analytics/metrics
/v1/analytics/metrics
Get data of a specific metric (aggregated)
{
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/GetMetricDataInput"
},
"example": {
"id": "closed_conversationsX",
"filters": [
{
"values": [
"email"
],
"attribute": "channel"
}
],
"timezone": "Europe/Copenhagen",
"aggregations": [
"Count"
],
"periodFilter": {
"_type": "Preset",
"value": {
"_type": "PreviousWeek"
}
}
}
}
},
"required": true,
"description": "The available request filters and aggregations for fetching the metric data"
}
POST /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 |
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. |
GET /v1/analytics/records
/v1/analytics/records
Get data of specific metric records (unaggregated)
| 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. |
{
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/GetMetricRecordsDataInput"
},
"example": {
"id": "closed_conversationsX",
"filters": [
{
"values": [
"INBOUND"
],
"attribute": "initial_direction"
}
],
"timezone": "Europe/Copenhagen",
"periodFilter": {
"_type": "Preset",
"value": {
"_type": "PreviousWeek"
}
}
}
}
},
"required": true,
"description": "The available request filters for fetching the metric records data"
}
POST /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 |
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 |
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] |
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 |
GET /v1/contact-endpoints/{contactEndpointId}
/v1/conversations
Create a conversation. For inbound messages the author is assumed to be the requester of the conversation (end user). For outbound messages the author is specified using the agentId field.
{
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CreateConversationInput"
},
"example": {
"_type": "Email",
"message": {
"_type": "Inbound",
"content": {
"_type": "Text",
"value": "My order hasn't shipped"
},
"attachments": []
},
"subject": "order #123",
"language": "en",
"requesterId": "9c2a2cce-699f-4a72-89d9-fda5bc8dec8b",
"emailIntegrationId": "my-integration@email.dixa.io"
}
}
},
"required": true,
"description": "The conversation to create"
}
POST /v1/conversations
/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' |
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] |
GET /v1/conversations/flows
/v1/conversations/{conversationId}
Get a conversation by id.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| conversationId | path | required | integer |
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 |
GET /v1/conversations/{conversationId}/activitylog
/v1/conversations/{conversationId}/claim
Claim a conversation for a given agent. To avoid taking over assigned conversations, set the `force` paremeter to false
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| conversationId | path | required | integer |
{
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ClaimConversationInput"
},
"example": {
"force": false,
"agentId": "5a556159-9c21-4f3e-a44f-d323deb80d16"
}
}
},
"required": true
}
PUT /v1/conversations/{conversationId}/claim
/v1/conversations/{conversationId}/close
Mark a conversation as closed by providing its id.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| conversationId | path | required | integer |
{
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CloseConversationInput"
},
"example": {
"userId": "5a556159-9c21-4f3e-a44f-d323deb80d16"
}
}
},
"required": false,
"description": "An optional agent/admin to close the conversation"
}
PUT /v1/conversations/{conversationId}/close
/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 |
GET /v1/conversations/{conversationId}/linked
/v1/conversations/{conversationId}/messages
Add a message to a conversation. For inbound messages the author is assumed to be the requester of the conversation (end user). For outbound messages the author is specified using the agentId field. Currently Email, WidgetChat and Messenger channels are supported.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| conversationId | path | required | integer |
{
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CreateMessageInput"
},
"example": {
"_type": "Inbound",
"content": {
"_type": "Html",
"value": "I need some help!"
},
"attachments": [
{
"url": "http://attachment.url",
"prettyName": "Filename"
}
]
}
}
},
"required": true,
"description": "The message to be added to a conversation"
}
POST /v1/conversations/{conversationId}/messages
/v1/conversations/{conversationId}/reopen
Reopen a conversation and offer it in the same queue. Falls back to the default organization queue if the conversation has no target queue.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| conversationId | path | required | integer |
{
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ReopenConversationInput"
},
"example": {
"userId": "a53b25da-f676-4c52-acac-58c9280aa23d"
}
}
},
"required": false,
"description": "An optional agent/admin to reopen the conversation"
}
PUT /v1/conversations/{conversationId}/reopen
/v1/conversations/{conversationId}/transfer/queue
Transfer a conversation to a target queue.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| conversationId | path | required | integer |
{
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/TransferConversationInput"
},
"example": {
"userId": "a53b25da-f676-4c52-acac-58c9280aa23d",
"queueId": "92f8d193-b26f-4a62-86a3-bb03ee0915e9"
}
}
},
"required": true,
"description": "Transfer conversation request"
}
PUT /v1/conversations/{conversationId}/transfer/queue
/v1/conversations/{conversationId}/anonymize
Request the anonymization of a conversation.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| conversationId | path | required | integer | the id of the conversation to anonymize |
| force | query | optional | boolean | Whether to force close the conversation if it is found in a non closed state. |
PATCH /v1/conversations/{conversationId}/anonymize
/v1/conversations/{conversationId}/messages/{messageId}/anonymize
Request the anonymization of a single message in a conversation.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| conversationId | path | required | integer | the id of the conversation in which the message belongs |
| messageId | path | required | string | the id of the message to anonymize |
PATCH /v1/conversations/{conversationId}/messages/{messageId}/anonymize
/v1/conversations/{conversationId}/custom-attributes
Patch custom attributes of a conversation
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| conversationId | path | required | integer |
{
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Map_UUID_Option_AttributeValue"
},
"example": {
"2f5515b6-7e98-4f4d-9010-bfd2a27d4f35": "012345",
"e14708a6-eed9-495c-9d88-c72331e9e247": [
"str1",
"str2"
]
}
}
},
"required": true,
"description": "The custom attributes of an conversation to be patched. This should map the custom attribute id to the desired attribute value. Format: Map[UUID, Option[AttributeValue]."
}
PATCH /v1/conversations/{conversationId}/custom-attributes
/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 |
GET /v1/conversations/{conversationId}/notes
/v1/conversations/{conversationId}/notes
Create an internal note in a conversation by providing the conversation id.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| conversationId | path | required | integer |
{
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CreateInternalNoteInput"
},
"examples": {
"Input with createdAt": {
"value": {
"agentId": "a53b25da-f676-4c52-acac-58c9280aa23d",
"message": "A sample note",
"createdAt": "2021-12-01T12:46:36.581Z[GMT]"
}
},
"Input without createdAt": {
"value": {
"message": "Another sample note"
}
}
}
}
},
"required": true,
"description": "The internal note to create for a conversation"
}
POST /v1/conversations/{conversationId}/notes
/v1/conversations/{conversationId}/notes/bulk
Create internal notes in a conversation by providing the conversation id.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| conversationId | path | required | integer |
{
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BulkCreateInternalNoteInput"
},
"examples": {
"Input with two internal notes created for the same conversation": {
"value": {
"data": [
{
"agentId": "a53b25da-f676-4c52-acac-58c9280aa23d",
"message": "A sample note",
"createdAt": "2021-12-01T12:46:36.581Z[GMT]"
},
{
"message": "Another sample note"
}
]
}
}
}
}
},
"required": true,
"description": "The list of internal notes to create for a conversation"
}
POST /v1/conversations/{conversationId}/notes/bulk
/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 |
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 |
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 |
GET /v1/conversations/{conversationId}/tags
/v1/conversations/{conversationId}/tags/{tagId}
Untag a conversation. You may remove active or inactive tags from a conversation.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| conversationId | path | required | integer | |
| tagId | path | required | string |
DELETE /v1/conversations/{conversationId}/tags/{tagId}
/v1/conversations/{conversationId}/tags/{tagId}
Tag a conversation. You may only use active tags to tag conversations.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| conversationId | path | required | integer | |
| tagId | path | required | string |
PUT /v1/conversations/{conversationId}/tags/{tagId}
/v1/custom-attributes
List all custom attributes in an organization.
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 |
GET /v1/endusers
/v1/endusers
Bulk patch end users.
{
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BulkPatchEndUsersInput"
},
"example": {
"data": [
{
"id": "43b1fe06-a7c4-4f34-8e48-b0559e6acdb9",
"email": "alice@brown.com",
"lastName": "Brown",
"avatarUrl": "http://avatar.url",
"firstName": "Alice",
"externalId": "#12345678",
"displayName": "Alice Brown",
"middleNames": [],
"phoneNumber": "+551155256325",
"additionalEmails": [
"alice@secondary.email"
],
"additionalPhoneNumbers": [
"+5566778899"
]
}
]
}
}
},
"required": true,
"description": "List of end user patch actions"
}
PATCH /v1/endusers
/v1/endusers
Create an end user.
{
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CreateEndUserInput"
},
"example": {
"email": "alice@brown.com",
"lastName": "Brown",
"avatarUrl": "http://avatar.url",
"firstName": "Alice",
"externalId": "#12345678",
"displayName": "Alice Brown",
"middleNames": [],
"phoneNumber": "+551155256325",
"additionalEmails": [
"alice@secondary.email"
],
"additionalPhoneNumbers": [
"+5566778899"
]
}
}
},
"required": true,
"description": "The end user's details"
}
POST /v1/endusers
/v1/endusers
Bulk update end users.
{
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BulkUpdateEndUsersInput"
},
"example": {
"data": [
{
"id": "d4826125-559f-496f-ad71-a0340f0cae06",
"email": "alice@brown.com",
"lastName": "Brown",
"avatarUrl": "http://avatar.url",
"firstName": "Alice",
"externalId": "#12345678",
"displayName": "Alice Brown",
"middleNames": [
"J."
],
"phoneNumber": "+551155256325",
"additionalEmails": [
"alice@secondary.email"
],
"additionalPhoneNumbers": [
"+5566778899"
]
}
]
}
}
},
"required": true,
"description": "List of end user update actions"
}
PUT /v1/endusers
/v1/endusers/bulk
Create end users.
{
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CreateEndUsersInput"
},
"example": {
"data": [
{
"email": "alice@brown.com",
"lastName": "Brown",
"avatarUrl": "http://avatar.url",
"firstName": "Alice",
"externalId": "#12345678",
"displayName": "Alice Brown",
"middleNames": [],
"phoneNumber": "+551155256325",
"additionalEmails": [],
"additionalPhoneNumbers": []
}
]
}
}
},
"required": true,
"description": "The list of end user details"
}
POST /v1/endusers/bulk
/v1/endusers/{userId}
Get an end user by id.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| userId | path | required | string | The end user id |
GET /v1/endusers/{userId}
/v1/endusers/{userId}
Patch an end user.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| userId | path | required | string | The end user id to be patched |
{
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PatchEndUserInput"
},
"example": {
"email": "alice@brown.com",
"lastName": "Brown",
"avatarUrl": "http://avatar.url",
"firstName": "Alice",
"externalId": "#12345678",
"displayName": "Alice Brown",
"middleNames": [],
"phoneNumber": "+551155256325",
"additionalEmails": [
"alice@secondary.email"
],
"additionalPhoneNumbers": [
"+5566778899"
]
}
}
},
"required": true,
"description": "The end user patch"
}
PATCH /v1/endusers/{userId}
/v1/endusers/{userId}
Update an end user.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| userId | path | required | string | The end user id |
{
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/UpdateEndUserInput"
},
"example": {
"email": "alice@brown.com",
"lastName": "Brown",
"avatarUrl": "http://avatar.url",
"firstName": "Alice",
"externalId": "#12345678",
"displayName": "Alice Brown",
"middleNames": [
"J."
],
"phoneNumber": "+551155256325",
"additionalEmails": [
"alice@secondary.email"
],
"additionalPhoneNumbers": [
"+5566778899"
]
}
}
},
"required": true,
"description": "The updated details for an end user"
}
PUT /v1/endusers/{userId}
/v1/endusers/{userId}/conversations
Lists conversations requested by an end user. <br/> 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}](../Conversations/#tag/Conversations/operation/getConversationsConversationid) 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. |
GET /v1/endusers/{userId}/conversations
/v1/endusers/{userId}/anonymize
Request the anonymization of an end user.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| userId | path | required | string | The id of the end user to anonymize |
| force | query | optional | boolean | Whether to force close all the conversations initiated by the end user, if any are found in a non closed state. |
PATCH /v1/endusers/{userId}/anonymize
/v1/endusers/{userId}/custom-attributes
Patch custom attributes of an end user
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| userId | path | required | string |
{
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Map_UUID_Option_AttributeValue"
},
"example": {
"274e5a2c-be0d-42c0-b725-3dd533729f68": "abcdef",
"befae0d9-9679-42b9-af76-e76f64e28429": [
"example1",
"example2"
]
}
}
},
"required": true,
"description": "The custom attributes of an end user to be patched. This should map the custom attribute id to the desired attribute value. Format: Map[UUID, Option[AttributeValue]."
}
PATCH /v1/endusers/{userId}/custom-attributes
/v1/queues
List all queues in an organization.
GET /v1/queues
/v1/queues
Create a queue.
{
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CreateQueueInput"
},
"example": {
"request": {
"name": "MyCorp main queue",
"priority": 1,
"isDefault": true,
"offerTimeout": 10,
"wrapupTimeout": 10,
"offerAlgorithm": "AllAtOnce",
"queueThresholds": {
"WaitingConversations": 10
},
"callFunctionality": false,
"doNotOfferTimeouts": {
"WidgetChat": 1
},
"isDoNotOfferEnabled": true,
"preferredAgentTimeouts": {
"Email": 43200,
"Callback": 300,
"WhatsApp": 300,
"PstnPhone": 300,
"Voicemail": 300,
"WidgetChat": 300,
"ContactForm": 43200,
"FacebookMessenger": 300
},
"isPreferredAgentEnabled": false,
"offerAbandonedConversations": false,
"personalAgentOfflineTimeout": 500,
"preferredAgentOfflineTimeout": 500
}
}
}
},
"required": true,
"description": "The details for creating a queue"
}
POST /v1/queues
/v1/queues/{queueId}
Get a queue by id.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| queueId | path | required | string |
GET /v1/queues/{queueId}
/v1/queues/{queueId}/members
Bulk remove agents/admins from the specified queue.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| queueId | path | required | string |
{
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BulkQueueEndpointInput"
},
"example": {
"agentIds": [
"743c3781-c882-4352-a1fa-fe5d7a673cfd",
"cad2f234-8cec-4cd8-96e9-a6491a0176da"
]
}
}
},
"required": true,
"description": "The list of agents/admins to be removed from the queue. Up to 10 members can be specified."
}
DELETE /v1/queues/{queueId}/members
/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 |
GET /v1/queues/{queueId}/members
/v1/queues/{queueId}/members
Assign one or more agents/admins to a given queue.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| queueId | path | required | string |
{
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BulkQueueEndpointInput"
},
"example": {
"agentIds": [
"c31e5e3f-1d5f-4442-83df-fd7bddd59da4",
"26ae145b-8644-4fa5-aa56-7b3dcacbe2d4"
]
}
}
},
"required": true,
"description": "The list of agents/admins to be added to the queue"
}
PATCH /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. |
GET /v1/search/conversations
/v1/tags
List all tags in an organization.
GET /v1/tags
/v1/tags
Create a tag.
{
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CreateTagInput"
},
"example": {
"name": "test",
"color": "#000000"
}
}
},
"required": true,
"description": "The tag details"
}
POST /v1/tags
/v1/tags/{tagId}
Get a tag by id.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| tagId | path | required | string |
GET /v1/tags/{tagId}
/v1/tags/{tagId}/activate
Activate a tag.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| tagId | path | required | string | The tag id |
PATCH /v1/tags/{tagId}/activate
/v1/tags/{tagId}/deactivate
Deactivate a tag.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| tagId | path | required | string | The tag id |
PATCH /v1/tags/{tagId}/deactivate
/v1/teams
Lists all teams in an organization.
GET /v1/teams
/v1/teams
Create a team.
{
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CreateTeamInput"
},
"example": {
"name": "Team A"
}
}
},
"required": true,
"description": "The team name"
}
POST /v1/teams
/v1/teams/{teamId}
Delete a team.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| teamId | path | required | string | The team id |
DELETE /v1/teams/{teamId}
/v1/teams/{teamId}
Get a team by id.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| teamId | path | required | string | The team id |
GET /v1/teams/{teamId}
/v1/teams/{teamId}/agents
Remove agents/admins from a team.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| teamId | path | required | string | The team id |
{
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DeleteAgentsFromTeamInput"
},
"example": {
"agentIds": [
"a8080cf3-9d55-41dd-a8ef-b02414399e7a",
"d53dbec1-e79c-4736-b9a1-15f6dce71ed4"
]
}
}
},
"required": true,
"description": "List of agent/admin ids to remove from the specified team"
}
DELETE /v1/teams/{teamId}/agents
/v1/teams/{teamId}/agents
Lists all agents/admins in a team.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| teamId | path | required | string | The team id |
GET /v1/teams/{teamId}/agents
/v1/teams/{teamId}/agents
Add agents/admins to a team.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| teamId | path | required | string | The team id |
{
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/AgentsToTeamInput"
},
"example": {
"agentIds": [
"912d5148-6918-4420-b23a-8584b896c8ae",
"a8080cf3-9d55-41dd-a8ef-b02414399e7a"
]
}
}
},
"required": true,
"description": "List of agent/admin ids to add to the specified team"
}
PATCH /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. |
GET /v1/teams/{teamId}/presence
/v1/webhooks
List of all Webhook Subscriptions in an organization.
GET /v1/webhooks
/v1/webhooks
Create a Webhook Subscription.
{
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CreateWebhookSubscriptionInput"
},
"example": {
"url": "https://example.webhook/dashboard_integration",
"name": "Dashboard Integration",
"events": [
"ConversationCreated",
"ConversationClosed"
],
"enabled": true,
"authorization": {
"_type": "BasicAuth",
"password": "webhook_password",
"username": "webhook_user"
}
}
}
},
"required": true,
"description": "The Webhook Subscription to be created"
}
POST /v1/webhooks
/v1/webhooks/{webhookSubscriptionId}
Delete a Webhook Subscription.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| webhookSubscriptionId | path | required | string |
DELETE /v1/webhooks/{webhookSubscriptionId}
/v1/webhooks/{webhookSubscriptionId}
Get a Webhook Subscription by ID.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| webhookSubscriptionId | path | required | string |
GET /v1/webhooks/{webhookSubscriptionId}
/v1/webhooks/{webhookSubscriptionId}
Patch a Webhook Subscription.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| webhookSubscriptionId | path | required | string |
{
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PatchWebhookSubscriptionInput"
},
"example": {
"name": "New name",
"events": [
"ConversationNoteAdded"
],
"authorization": {
"_type": "TokenAuth",
"value": "eyDoiGciOqGYUzI1NiJ4.eyJ0eQJRUapoYXBpIiwib4JxA5lkIjoiNTVmMmE6MmItYjU4NF33MDMxLTk2NTktOTE2M.qPoOZoQYDn4rn-akaLmVFka15JAV7TF6QT8UHOUTIy0"
}
}
}
},
"required": true,
"description": "The Webhook Subscription fields to be patched"
}
PATCH /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 |
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 |
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"
}
}
}
Chat
{
"type": "object",
"required": [
"requesterId",
"widgetId",
"message"
],
"properties": {
"message": {
"$ref": "#/components/schemas/CreateMessageInput"
},
"language": {
"type": "string"
},
"widgetId": {
"type": "string",
"format": "uuid"
},
"browserInfo": {
"$ref": "#/components/schemas/BrowserInfo"
},
"requesterId": {
"type": "string",
"format": "uuid"
}
}
}
ChatAttributes
{
"type": "object",
"required": [
"isAutomated"
],
"properties": {
"content": {
"$ref": "#/components/schemas/Content"
},
"direction": {
"type": "string",
"description": "values: [Inbound, Internal, Outbound]"
},
"attachments": {
"type": "array",
"items": {
"$ref": "#/components/schemas/File"
}
},
"isAutomated": {
"type": "boolean"
}
}
}
ChatConversation
{
"type": "object",
"required": [
"id",
"requesterId",
"channel",
"createdAt"
],
"properties": {
"id": {
"type": "integer",
"format": "int64"
},
"link": {
"$ref": "#/components/schemas/ConversationLink"
},
"queue": {
"$ref": "#/components/schemas/Queue"
},
"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]"
},
"language": {
"type": "string"
},
"createdAt": {
"type": "string",
"format": "date-time"
},
"direction": {
"type": "string",
"description": "values: [Inbound, Internal, Outbound]"
},
"assignment": {
"$ref": "#/components/schemas/Assignment"
},
"browserInfo": {
"$ref": "#/components/schemas/BrowserInfo"
},
"requesterId": {
"type": "string",
"format": "uuid"
},
"stateUpdatedAt": {
"type": "string",
"format": "date-time"
},
"customAttributes": {
"type": "array",
"items": {
"$ref": "#/components/schemas/CustomAttribute"
}
}
}
}
ClaimConversationInput
{
"type": "object",
"required": [
"agentId"
],
"properties": {
"force": {
"type": "boolean",
"description": "Set as false to avoid taking over the conversation if it is already assigned to an agent"
},
"agentId": {
"type": "string",
"format": "uuid",
"description": "The id of the agent who is claiming the conversation"
}
}
}
CloseConversationInput
{
"type": "object",
"properties": {
"userId": {
"type": "string",
"format": "uuid"
}
}
}
Conflict
{
"type": "object",
"required": [
"message"
],
"properties": {
"message": {
"type": "string"
}
}
}
ContactEndpoint
{
"oneOf": [
{
"$ref": "#/components/schemas/EmailEndpoint"
},
{
"$ref": "#/components/schemas/TelephonyEndpoint"
}
]
}
ContactForm
{
"type": "object",
"required": [
"requesterId",
"emailIntegrationId",
"subject",
"message"
],
"properties": {
"message": {
"$ref": "#/components/schemas/CreateMessageInput"
},
"subject": {
"type": "string"
},
"language": {
"type": "string"
},
"requesterId": {
"type": "string",
"format": "uuid"
},
"emailIntegrationId": {
"type": "string"
}
}
}
ContactFormAttributes
{
"type": "object",
"required": [
"isAutoReply"
],
"properties": {
"cc": {
"type": "array",
"items": {
"$ref": "#/components/schemas/EmailContact"
}
},
"to": {
"type": "array",
"items": {
"$ref": "#/components/schemas/EmailContact"
}
},
"bcc": {
"type": "array",
"items": {
"$ref": "#/components/schemas/EmailContact"
}
},
"from": {
"$ref": "#/components/schemas/EmailContact"
},
"direction": {
"type": "string",
"description": "values: [Inbound, Internal, Outbound]"
},
"attachments": {
"type": "array",
"items": {
"$ref": "#/components/schemas/File"
}
},
"isAutoReply": {
"type": "boolean"
},
"emailContent": {
"$ref": "#/components/schemas/EmailContent"
},
"inlineImages": {
"type": "array",
"items": {
"$ref": "#/components/schemas/File"
}
},
"originalContentUrl": {
"$ref": "#/components/schemas/File"
},
"replyDefaultToEmails": {
"type": "array",
"items": {
"$ref": "#/components/schemas/EmailContact"
}
},
"deliveryFailureReason": {
"type": "string"
}
}
}
ContactFormConversation
{
"type": "object",
"required": [
"id",
"requesterId",
"channel",
"createdAt",
"fromEmail"
],
"properties": {
"id": {
"type": "integer",
"format": "int64"
},
"link": {
"$ref": "#/components/schemas/ConversationLink"
},
"queue": {
"$ref": "#/components/schemas/Queue"
},
"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]"
},
"subject": {
"type": "string"
},
"toEmail": {
"type": "string"
},
"language": {
"type": "string"
},
"createdAt": {
"type": "string",
"format": "date-time"
},
"direction": {
"type": "string",
"description": "values: [Inbound, Internal, Outbound]"
},
"fromEmail": {
"type": "string"
},
"assignment": {
"$ref": "#/components/schemas/Assignment"
},
"requesterId": {
"type": "string",
"format": "uuid"
},
"stateUpdatedAt": {
"type": "string",
"format": "date-time"
},
"customAttributes": {
"type": "array",
"items": {
"$ref": "#/components/schemas/CustomAttribute"
}
},
"integrationEmail": {
"type": "string"
}
}
}
Content
{
"oneOf": [
{
"$ref": "#/components/schemas/Html"
},
{
"$ref": "#/components/schemas/Text"
}
]
}
Conversation
{
"oneOf": [
{
"$ref": "#/components/schemas/AnonymizedConversation"
},
{
"$ref": "#/components/schemas/ChatConversation"
},
{
"$ref": "#/components/schemas/ContactFormConversation"
},
{
"$ref": "#/components/schemas/EmailConversation"
},
{
"$ref": "#/components/schemas/FacebookMessengerConversation"
},
{
"$ref": "#/components/schemas/GenericConversation"
},
{
"$ref": "#/components/schemas/MessengerConversation"
},
{
"$ref": "#/components/schemas/PstnPhoneConversation"
},
{
"$ref": "#/components/schemas/SmsConversation"
},
{
"$ref": "#/components/schemas/TwitterConversation"
},
{
"$ref": "#/components/schemas/WhatsAppConversation"
}
]
}
ConversationAnonymizationType
{
"type": "object"
}
ConversationAssignedActivityType
{
"type": "object"
}
ConversationAssignedAttribute
{
"type": "object",
"required": [
"agentId"
],
"properties": {
"agentId": {
"type": "string"
},
"agentName": {
"type": "string"
}
}
}
ConversationAutoReplySentAttribute
{
"type": "object",
"required": [
"templateName"
],
"properties": {
"templateName": {
"type": "string"
}
}
}
ConversationAutoreplySentActivityType
{
"type": "object"
}
ConversationClaimedActivityType
{
"type": "object"
}
ConversationClaimedAttribute
{
"type": "object",
"properties": {
"claimedFromType": {
"type": "string"
},
"claimedFromLabel": {
"type": "string"
}
}
}
ConversationClosedActivityType
{
"type": "object"
}
ConversationCreatedAttribute
{
"type": "object",
"properties": {
"subject": {
"type": "string"
}
}
}
ConversationCreatedByAgentActivityType
{
"type": "object"
}
ConversationCreatedByCustomerActivityType
{
"type": "object"
}
ConversationEndUserReplacedActivityType
{
"type": "object"
}
ConversationEndUserReplacedAttribute
{
"type": "object",
"required": [
"oldUser",
"newUser"
],
"properties": {
"newUser": {
"$ref": "#/components/schemas/ActivityLogUser"
},
"oldUser": {
"$ref": "#/components/schemas/ActivityLogUser"
}
}
}
ConversationFlow
{
"type": "object",
"required": [
"id",
"name",
"channel",
"contactEndpointId"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"name": {
"type": "string"
},
"channel": {
"type": "string",
"description": "values: [WhatsApp, Voicemail, WidgetChat, FacebookMessenger, Twitter, Email, ContactForm, Callback, PstnPhone, Sms, Messenger]"
},
"contactEndpointId": {
"type": "string"
}
}
}
ConversationLanguageUpdatedActivityType
{
"type": "object"
}
ConversationLanguageUpdatedAttribute
{
"type": "object",
"required": [
"language"
],
"properties": {
"language": {
"type": "string"
}
}
}
ConversationLink
{
"oneOf": [
{
"$ref": "#/components/schemas/EmailForward"
},
{
"$ref": "#/components/schemas/FollowUp"
},
{
"$ref": "#/components/schemas/SideConversation"
}
]
}
ConversationOfferAcceptedActivityType
{
"type": "object"
}
ConversationOfferRejectedActivityType
{
"type": "object"
}
ConversationOfferTimeoutActivityType
{
"type": "object"
}
ConversationOfferedActivityType
{
"type": "object"
}
ConversationOfferedAttribute
{
"type": "object",
"properties": {
"agentNames": {
"type": "array",
"items": {
"type": "string"
}
},
"queueLabel": {
"type": "string"
}
}
}
ConversationPendingActivityType
{
"type": "object"
}
ConversationRatedActivityType
{
"type": "object"
}
ConversationRatedAttribute
{
"type": "object",
"required": [
"agent"
],
"properties": {
"agent": {
"$ref": "#/components/schemas/ActivityLogUser"
},
"score": {
"type": "integer",
"format": "int32"
},
"message": {
"type": "string"
}
}
}
ConversationRating
{
"type": "object",
"required": [
"id",
"ratingType",
"conversationChannel",
"userId",
"ratingStatus",
"timestamps"
],
"properties": {
"id": {
"type": "string"
},
"userId": {
"type": "string"
},
"agentId": {
"type": "string"
},
"language": {
"type": "string"
},
"ratingType": {
"type": "string",
"description": "values: [Csat, ThumbsUpOrDown]"
},
"timestamps": {
"$ref": "#/components/schemas/Map_String"
},
"ratingScore": {
"type": "integer",
"format": "int32"
},
"ratingStatus": {
"type": "string",
"description": "values: [Unscheduled, Offered, Rated, Scheduled, Cancelled]"
},
"ratingComment": {
"type": "string"
},
"conversationChannel": {
"type": "string",
"description": "values: [WhatsApp, Voicemail, WidgetChat, FacebookMessenger, Twitter, Email, ContactForm, Callback, PstnPhone, Sms, Messenger]"
}
}
}
ConversationRatingCancelledActivityType
{
"type": "object"
}
ConversationRatingOfferedActivityType
{
"type": "object"
}
ConversationRatingOfferedAttribute
{
"type": "object",
"required": [
"agent",
"user"
],
"properties": {
"user": {
"$ref": "#/components/schemas/ActivityLogUser"
},
"agent": {
"$ref": "#/components/schemas/ActivityLogUser"
}
}
}
ConversationRatingScheduledActivityType
{
"type": "object"
}
ConversationRatingScheduledAttribute
{
"type": "object",
"required": [
"ratingScheduledTime"
],
"properties": {
"ratingScheduledTime": {
"type": "string"
}
}
}
ConversationRatingUnscheduledActivityType
{
"type": "object"
}
ConversationReopenedActivityType
{
"type": "object"
}
ConversationReservedAttribute
{
"type": "object",
"required": [
"agent",
"queueId",
"queueName",
"reservationType",
"validUntil"
],
"properties": {
"agent": {
"$ref": "#/components/schemas/ActivityLogUser"
},
"queueId": {
"type": "string"
},
"queueName": {
"type": "string"
},
"validUntil": {
"type": "string"
},
"reservationType": {
"type": "string"
}
}
}
ConversationReservedType
{
"type": "object"
}
ConversationResponse
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"format": "int64"
}
}
}
ConversationSearchHit
{
"type": "object",
"required": [
"id",
"highlights"
],
"properties": {
"id": {
"type": "integer",
"format": "int64",
"description": "Identifier of a Conversation where a match was found"
},
"innerHits": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ConversationSearchInnerHit"
},
"description": "List of sub-entities (such as Messages) where a match was found"
},
"highlights": {
"$ref": "#/components/schemas/Map_Vector_String"
}
}
}
ConversationSearchInnerHit
{
"type": "object",
"required": [
"id",
"highlight"
],
"properties": {
"id": {
"type": "string",
"description": "Identifier of a sub-entity (such as a Message) where a match was found"
},
"highlight": {
"$ref": "#/components/schemas/Map_String"
}
}
}
ConversationTagsOutput
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Tag"
}
}
}
}
ConversationTransferredAttribute
{
"type": "object",
"required": [
"transferType",
"destinationType",
"destinationId"
],
"properties": {
"reason": {
"type": "string"
},
"transferType": {
"type": "string"
},
"destinationId": {
"type": "string"
},
"destinationType": {
"type": "string"
},
"destinationLabel": {
"type": "string"
}
}
}
ConversationUnassignedActivityType
{
"type": "object"
}
ConversationUnassignedAttribute
{
"type": "object",
"required": [
"agent"
],
"properties": {
"agent": {
"$ref": "#/components/schemas/ActivityLogUser"
}
}
}
CreateAgentInput
{
"type": "object",
"required": [
"displayName",
"email"
],
"properties": {
"email": {
"type": "string",
"description": "The agent's primary email address"
},
"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"
}
}
}
CreateAgentsInput
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/CreateAgentInput"
}
}
}
}
CreateAgentsOutput
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/BulkActionOutcome_BulkError_Agent"
}
}
}
}
CreateConversationInput
{
"oneOf": [
{
"$ref": "#/components/schemas/Callback"
},
{
"$ref": "#/components/schemas/Chat"
},
{
"$ref": "#/components/schemas/ContactForm"
},
{
"$ref": "#/components/schemas/Email"
},
{
"$ref": "#/components/schemas/Sms"
}
]
}
CreateConversationOutput
{
"type": "object",
"required": [
"data"
],
"properties": {
"data": {
"$ref": "#/components/schemas/ConversationResponse"
}
}
}
CreateEndUserInput
{
"type": "object",
"properties": {
"email": {
"type": "string",
"description": "The contact's primary email address"
},
"lastName": {
"type": "string",
"description": "The contact's last name"
},
"avatarUrl": {
"type": "string",
"description": "The url from which to load the contact's avatar"
},
"firstName": {
"type": "string",
"description": "The contact's first name"
},
"externalId": {
"type": "string",
"description": "Custom external identifier for the contact"
},
"displayName": {
"type": "string",
"description": "The contact's display name"
},
"middleNames": {
"type": "array",
"items": {
"type": "string"
},
"description": "The contact's middle names"
},
"phoneNumber": {
"type": "string",
"description": "The contact's primary phone number"
},
"additionalEmails": {
"type": "array",
"items": {
"type": "string"
},
"description": "Additional email addresses for the contact"
},
"additionalPhoneNumbers": {
"type": "array",
"items": {
"type": "string"
},
"description": "Additional phone numbers for the contact"
}
}
}
CreateEndUserOutput
{
"type": "object",
"required": [
"data"
],
"properties": {
"data": {
"$ref": "#/components/schemas/EndUser"
}
}
}
CreateEndUsersInput
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/CreateEndUserInput"
}
}
}
}
CreateEndUsersOutput
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/BulkActionOutcome_BulkError_EndUser"
}
}
}
}
CreateInternalNoteInput
{
"type": "object",
"required": [
"message"
],
"properties": {
"agentId": {
"type": "string",
"format": "uuid"
},
"message": {
"type": "string"
},
"createdAt": {
"type": "string",
"format": "date-time"
}
}
}
CreateMessageInput
{
"oneOf": [
{
"$ref": "#/components/schemas/Inbound"
},
{
"$ref": "#/components/schemas/Outbound"
}
]
}
CreateMessageOutput
{
"type": "object",
"required": [
"data"
],
"properties": {
"data": {
"$ref": "#/components/schemas/CreateMessageOutputData"
}
}
}
CreateMessageOutputData
{
"type": "object",
"required": [
"content",
"direction",
"authorId"
],
"properties": {
"content": {
"$ref": "#/components/schemas/Content"
},
"authorId": {
"type": "string",
"format": "uuid"
},
"createdAt": {
"type": "string"
},
"direction": {
"type": "string",
"description": "values: [Inbound, Internal, Outbound]"
},
"messageId": {
"type": "string",
"format": "uuid"
},
"externalId": {
"type": "string"
}
}
}
CreateNoteOutput
{
"type": "object",
"required": [
"data"
],
"properties": {
"data": {
"$ref": "#/components/schemas/InternalNoteData"
}
}
}
CreateOrUpdateQueueRequest
{
"type": "object",
"required": [
"name",
"callFunctionality",
"isDefault",
"isDoNotOfferEnabled"
],
"properties": {
"name": {
"type": "string"
},
"priority": {
"type": "integer",
"format": "int32"
},
"isDefault": {
"type": "boolean"
},
"offerTimeout": {
"type": "integer",
"format": "int32"
},
"wrapupTimeout": {
"type": "integer",
"format": "int32"
},
"offerAlgorithm": {
"type": "string",
"description": "values: [AgentPriorityOneAtATimeRandom, AllAtOnce, AgentPriorityLongestIdle, AgentPriorityAllAtOnce, LongestIdle, OneAtATimeRandom]"
},
"queueThresholds": {
"$ref": "#/components/schemas/Map_QueueThreshold_Int"
},
"callFunctionality": {
"type": "boolean"
},
"doNotOfferTimeouts": {
"$ref": "#/components/schemas/Map_ConversationChannel_Int"
},
"isDoNotOfferEnabled": {
"type": "boolean"
},
"preferredAgentTimeouts": {
"$ref": "#/components/schemas/Map_ConversationChannel_Int"
},
"isPreferredAgentEnabled": {
"type": "boolean"
},
"offerAbandonedConversations": {
"type": "boolean"
},
"personalAgentOfflineTimeout": {
"type": "integer",
"format": "int32"
},
"preferredAgentOfflineTimeout": {
"type": "integer",
"format": "int32"
}
}
}
CreateQueueInput
{
"type": "object",
"required": [
"request"
],
"properties": {
"request": {
"$ref": "#/components/schemas/CreateOrUpdateQueueRequest"
}
}
}
CreateQueueOutput
{
"type": "object",
"required": [
"data"
],
"properties": {
"data": {
"$ref": "#/components/schemas/Queue1"
}
}
}
CreateTagInput
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
},
"color": {
"type": "string"
}
}
}
CreateTagOutput
{
"type": "object",
"required": [
"data"
],
"properties": {
"data": {
"$ref": "#/components/schemas/Tag"
}
}
}
CreateTeamInput
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
}
}
}
CreateTeamOutput
{
"type": "object",
"required": [
"data"
],
"properties": {
"data": {
"$ref": "#/components/schemas/Team1"
}
}
}
CreateWebhookSubscriptionInput
{
"type": "object",
"required": [
"name",
"url",
"authorization"
],
"properties": {
"url": {
"type": "string",
"description": "URL of the server that the webhook request should be sent to"
},
"name": {
"type": "string",
"description": "The Webhook Subscription name"
},
"events": {
"type": "array",
"items": {
"type": "string",
"description": "values: [ConversationPending, AgentUnbannedEnduser, ConversationMessageAdded, ConversationTagAdded, AgentBannedIp, ConversationAssigned, ConversationPendingExpired, ConversationTransferred, ConversationEnqueued, ConversationCreated, ConversationUnassigned, ConversationOpen, ConversationAbandoned, ConversationClosed, ConversationNoteAdded, AgentBannedEnduser, ConversationEndUserReplaced, AgentUnbannedIp, ConversationTagRemoved, ConversationRated]"
},
"description": "The set of events this Webhook Subscription subscribes to. Allowed values: [ConversationPending, AgentUnbannedEnduser, ConversationMessageAdded, ConversationTagAdded, AgentBannedIp, ConversationAssigned, ConversationPendingExpired, ConversationTransferred, ConversationEnqueued, ConversationCreated, ConversationUnassigned, ConversationOpen, ConversationAbandoned, ConversationClosed, ConversationNoteAdded, AgentBannedEnduser, ConversationEndUserReplaced, AgentUnbannedIp, ConversationTagRemoved, ConversationRated]"
},
"enabled": {
"type": "boolean",
"description": "Defines whether this Webhook Subscription is enabled or disabled. Default is `true`"
},
"authorization": {
"$ref": "#/components/schemas/WebhookAuthorization"
}
}
}
CreateWebhookSubscriptionOutput
{
"type": "object",
"required": [
"data"
],
"properties": {
"data": {
"$ref": "#/components/schemas/WebhookSubscription"
}
}
}
CustomAttribute
{
"type": "object",
"required": [
"id",
"name",
"identifier",
"value"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"name": {
"type": "string"
},
"value": {
"oneOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "string"
}
],
"description": "AttributeValue values: String[] if the type of the custom attribute is Select or String if the type of the custom attribute is Text"
},
"identifier": {
"type": "string"
}
}
}
CustomAttributeDefinition
{
"type": "object",
"required": [
"id",
"entityType",
"identifier",
"label",
"inputDefinition",
"createdAt",
"isRequired",
"isArchived",
"isDeactivated"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"label": {
"type": "string"
},
"createdAt": {
"type": "string",
"format": "date-time"
},
"updatedAt": {
"type": "string",
"format": "date-time"
},
"entityType": {
"type": "string",
"description": "values: [Contact, Conversation]"
},
"identifier": {
"type": "string"
},
"isArchived": {
"type": "boolean"
},
"isRequired": {
"type": "boolean"
},
"description": {
"type": "string"
},
"isDeactivated": {
"type": "boolean"
},
"inputDefinition": {
"$ref": "#/components/schemas/CustomAttributeInputDefinition"
}
}
}
CustomAttributeInputDefinition
{
"oneOf": [
{
"$ref": "#/components/schemas/Select"
},
{
"$ref": "#/components/schemas/Text1"
}
]
}
DeleteAgentsFromTeamInput
{
"type": "object",
"properties": {
"agentIds": {
"type": "array",
"items": {
"type": "string",
"format": "uuid"
}
}
}
}
DeliveryDetail
{
"type": "object",
"required": [
"deliveryTimestamp",
"success",
"responseCode",
"responseText"
],
"properties": {
"success": {
"type": "boolean"
},
"responseCode": {
"type": "integer",
"format": "int32"
},
"responseText": {
"type": "string"
},
"deliveryTimestamp": {
"type": "string"
}
}
}
DeliveryStatus
{
"oneOf": [
{
"$ref": "#/components/schemas/DeliveryDetail"
},
{
"$ref": "#/components/schemas/NoRecentDelivery"
}
]
}
DeprecatedActivityLogType
{
"oneOf": [
{
"$ref": "#/components/schemas/ConversationAssignedActivityType"
},
{
"$ref": "#/components/schemas/ConversationAutoreplySentActivityType"
},
{
"$ref": "#/components/schemas/ConversationClaimedActivityType"
},
{
"$ref": "#/components/schemas/ConversationClosedActivityType"
},
{
"$ref": "#/components/schemas/ConversationCreatedByAgentActivityType"
},
{
"$ref": "#/components/schemas/ConversationCreatedByCustomerActivityType"
},
{
"$ref": "#/components/schemas/ConversationEndUserReplacedActivityType"
},
{
"$ref": "#/components/schemas/ConversationLanguageUpdatedActivityType"
},
{
"$ref": "#/components/schemas/ConversationOfferAcceptedActivityType"
},
{
"$ref": "#/components/schemas/ConversationOfferRejectedActivityType"
},
{
"$ref": "#/components/schemas/ConversationOfferTimeoutActivityType"
},
{
"$ref": "#/components/schemas/ConversationOfferedActivityType"
},
{
"$ref": "#/components/schemas/ConversationPendingActivityType"
},
{
"$ref": "#/components/schemas/ConversationRatedActivityType"
},
{
"$ref": "#/components/schemas/ConversationRatingCancelledActivityType"
},
{
"$ref": "#/components/schemas/ConversationRatingOfferedActivityType"
},
{
"$ref": "#/components/schemas/ConversationRatingScheduledActivityType"
},
{
"$ref": "#/components/schemas/ConversationRatingUnscheduledActivityType"
},
{
"$ref": "#/components/schemas/ConversationReopenedActivityType"
},
{
"$ref": "#/components/schemas/ConversationReservedType"
},
{
"$ref": "#/components/schemas/ConversationUnassignedActivityType"
},
{
"$ref": "#/components/schemas/FollowupAddedActivityType"
},
{
"$ref": "#/components/schemas/FollowupExpiredActivityType"
},
{
"$ref": "#/components/schemas/FollowupRemovedActivityType"
},
{
"$ref": "#/components/schemas/MessageAddedByAgentActivityType"
},
{
"$ref": "#/components/schemas/MessageAddedByCustomerActivityType"
},
{
"$ref": "#/components/schemas/NoteAddedActivityType"
},
{
"$ref": "#/components/schemas/TagAddedActivityType"
},
{
"$ref": "#/components/schemas/TagRemovedActivityType"
},
{
"$ref": "#/components/schemas/TransferFailedActivityType"
},
{
"$ref": "#/components/schemas/TransferInitiatedActivityType"
},
{
"$ref": "#/components/schemas/TransferSuccessfulActivityType"
},
{
"$ref": "#/components/schemas/UnknownActivityType"
}
],
"deprecated": true,
"description": "Replaced by _type field"
}
DeprecatedAnonymizationType
{
"oneOf": [
{
"$ref": "#/components/schemas/ConversationAnonymizationType"
},
{
"$ref": "#/components/schemas/MessageAnonymizationType"
},
{
"$ref": "#/components/schemas/UnknownAnonymizationType"
},
{
"$ref": "#/components/schemas/UserAnonymizationType"
}
],
"deprecated": true,
"description": "Replaced by _type field"
}
DoubleAggregateValue
{
"type": "object",
"required": [
"value",
"measure"
],
"properties": {
"value": {
"type": "number",
"format": "double"
},
"measure": {
"type": "string",
"description": "values: [Min, Max, Sum, Percentage, StdDev, Average]"
}
}
}
DoubleField
{
"type": "object",
"required": [
"value"
],
"properties": {
"value": {
"type": "number",
"format": "double"
}
}
}
Email
{
"type": "object",
"required": [
"requesterId",
"emailIntegrationId",
"subject",
"message"
],
"properties": {
"message": {
"$ref": "#/components/schemas/CreateMessageInput"
},
"subject": {
"type": "string"
},
"language": {
"type": "string"
},
"requesterId": {
"type": "string",
"format": "uuid"
},
"emailIntegrationId": {
"type": "string"
}
}
}
EmailAttributes
{
"type": "object",
"required": [
"from",
"isAutoReply"
],
"properties": {
"cc": {
"type": "array",
"items": {
"$ref": "#/components/schemas/EmailContact"
}
},
"to": {
"type": "array",
"items": {
"$ref": "#/components/schemas/EmailContact"
}
},
"bcc": {
"type": "array",
"items": {
"$ref": "#/components/schemas/EmailContact"
}
},
"from": {
"$ref": "#/components/schemas/EmailContact"
},
"direction": {
"type": "string",
"description": "values: [Inbound, Internal, Outbound]"
},
"attachments": {
"type": "array",
"items": {
"$ref": "#/components/schemas/File"
}
},
"isAutoReply": {
"type": "boolean"
},
"emailContent": {
"$ref": "#/components/schemas/EmailContent"
},
"inlineImages": {
"type": "array",
"items": {
"$ref": "#/components/schemas/File"
}
},
"originalContentUrl": {
"$ref": "#/components/schemas/File"
},
"deliveryFailureReason": {
"type": "string"
}
}
}
EmailContact
{
"type": "object",
"required": [
"email"
],
"properties": {
"name": {
"type": "string"
},
"email": {
"type": "string"
}
}
}
EmailContent
{
"oneOf": [
{
"$ref": "#/components/schemas/Regular"
},
{
"$ref": "#/components/schemas/TooLarge"
}
]
}
EmailConversation
{
"type": "object",
"required": [
"id",
"requesterId",
"channel",
"createdAt",
"toEmail",
"fromEmail",
"integrationEmail"
],
"properties": {
"id": {
"type": "integer",
"format": "int64"
},
"link": {
"$ref": "#/components/schemas/ConversationLink"
},
"queue": {
"$ref": "#/components/schemas/Queue"
},
"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]"
},
"subject": {
"type": "string"
},
"toEmail": {
"type": "string"
},
"language": {
"type": "string"
},
"createdAt": {
"type": "string",
"format": "date-time"
},
"direction": {
"type": "string",
"description": "values: [Inbound, Internal, Outbound]"
},
"fromEmail": {
"type": "string"
},
"assignment": {
"$ref": "#/components/schemas/Assignment"
},
"requesterId": {
"type": "string",
"format": "uuid"
},
"stateUpdatedAt": {
"type": "string",
"format": "date-time"
},
"customAttributes": {
"type": "array",
"items": {
"$ref": "#/components/schemas/CustomAttribute"
}
},
"integrationEmail": {
"type": "string"
}
}
}
EmailEndpoint
{
"type": "object",
"required": [
"address"
],
"properties": {
"name": {
"type": "string"
},
"address": {
"type": "string"
},
"senderOverride": {
"type": "string"
}
}
}
EmailForward
{
"type": "object",
"required": [
"parentId"
],
"properties": {
"parentId": {
"type": "integer",
"format": "int64"
}
}
}
EmptyPatchSet
{
"type": "object",
"required": [
"id",
"message"
],
"properties": {
"id": {
"type": "string"
},
"message": {
"type": "string"
}
}
}
EndUser
{
"type": "object",
"required": [
"id",
"createdAt"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "Unique identifier for the contact"
},
"email": {
"type": "string",
"description": "The contact's primary email address"
},
"lastName": {
"type": "string",
"description": "The contact's last name"
},
"avatarUrl": {
"type": "string",
"description": "The url from which to load the contact's avatar"
},
"createdAt": {
"type": "string",
"format": "date-time",
"description": "Time when the contact was created"
},
"firstName": {
"type": "string",
"description": "The contact's first name"
},
"externalId": {
"type": "string",
"description": "Custom external identifier for the contact"
},
"displayName": {
"type": "string",
"description": "The contact's display name"
},
"middleNames": {
"type": "array",
"items": {
"type": "string"
},
"description": "The contact's middle names"
},
"phoneNumber": {
"type": "string",
"description": "The contact's primary phone number"
},
"additionalEmails": {
"type": "array",
"items": {
"type": "string"
},
"description": "Additional email addresses for the contact"
},
"customAttributes": {
"type": "array",
"items": {
"$ref": "#/components/schemas/CustomAttribute"
},
"description": "Custom attributes for the contact"
},
"additionalPhoneNumbers": {
"type": "array",
"items": {
"type": "string"
},
"description": "Additional phone numbers for the contact"
}
}
}
ErrorResponse
{
"type": "object",
"required": [
"message"
],
"properties": {
"message": {
"type": "string"
}
}
}
EventDeliveryLog
{
"type": "object",
"required": [
"deliveryDetail",
"payload"
],
"properties": {
"payload": {
"type": "string"
},
"deliveryDetail": {
"$ref": "#/components/schemas/DeliveryDetail"
}
}
}
EventDeliveryStatus
{
"type": "object",
"required": [
"event",
"deliveryStatus"
],
"properties": {
"event": {
"type": "string",
"description": "values: [ConversationPending, AgentUnbannedEnduser, ConversationMessageAdded, ConversationTagAdded, AgentBannedIp, ConversationAssigned, ConversationPendingExpired, ConversationTransferred, ConversationEnqueued, ConversationCreated, ConversationUnassigned, ConversationOpen, ConversationAbandoned, ConversationClosed, ConversationNoteAdded, AgentBannedEnduser, ConversationEndUserReplaced, AgentUnbannedIp, ConversationTagRemoved, ConversationRated]"
},
"deliveryStatus": {
"$ref": "#/components/schemas/DeliveryStatus"
}
}
}
FacebookMessengerAttributes
{
"type": "object",
"properties": {
"content": {
"$ref": "#/components/schemas/Content"
},
"direction": {
"type": "string",
"description": "values: [Inbound, Internal, Outbound]"
},
"attachments": {
"type": "array",
"items": {
"$ref": "#/components/schemas/File"
}
}
}
}
FacebookMessengerConversation
{
"type": "object",
"required": [
"id",
"requesterId",
"channel",
"createdAt"
],
"properties": {
"id": {
"type": "integer",
"format": "int64"
},
"link": {
"$ref": "#/components/schemas/ConversationLink"
},
"queue": {
"$ref": "#/components/schemas/Queue"
},
"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]"
},
"assignment": {
"$ref": "#/components/schemas/Assignment"
},
"requesterId": {
"type": "string",
"format": "uuid"
},
"stateUpdatedAt": {
"type": "string",
"format": "date-time"
},
"customAttributes": {
"type": "array",
"items": {
"$ref": "#/components/schemas/CustomAttribute"
}
}
}
}
Field
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
},
"field": {
"$ref": "#/components/schemas/FieldType"
}
}
}
FieldMetadata
{
"type": "object",
"required": [
"field",
"description",
"nullable"
],
"properties": {
"field": {
"type": "string"
},
"nullable": {
"type": "boolean"
},
"description": {
"type": "string"
}
}
}
FieldType
{
"oneOf": [
{
"$ref": "#/components/schemas/BooleanField"
},
{
"$ref": "#/components/schemas/DoubleField"
},
{
"$ref": "#/components/schemas/InstantField"
},
{
"$ref": "#/components/schemas/IntField"
},
{
"$ref": "#/components/schemas/ListField"
},
{
"$ref": "#/components/schemas/LongField"
},
{
"$ref": "#/components/schemas/StringField"
},
{
"$ref": "#/components/schemas/TimestampField"
},
{
"$ref": "#/components/schemas/UUIDField"
}
]
}
File
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "url"
},
"prettyName": {
"type": "string"
}
}
}
Filter
{
"type": "object",
"required": [
"attribute"
],
"properties": {
"values": {
"type": "array",
"items": {
"type": "string"
}
},
"attribute": {
"type": "string"
}
}
}
FilterMetadata
{
"type": "object",
"required": [
"filterAttribute"
],
"properties": {
"description": {
"type": "string"
},
"filterAttribute": {
"type": "string"
}
}
}
FilterValue
{
"type": "object",
"required": [
"value"
],
"properties": {
"label": {
"type": "string"
},
"value": {
"type": "string"
}
}
}
FollowUp
{
"type": "object",
"required": [
"parentId"
],
"properties": {
"parentId": {
"type": "integer",
"format": "int64"
}
}
}
FollowupAddedActivityType
{
"type": "object"
}
FollowupExpiredActivityType
{
"type": "object"
}
FollowupRemovedActivityType
{
"type": "object"
}
GenericAttributes
{
"type": "object",
"properties": {
"content": {
"$ref": "#/components/schemas/Content"
},
"direction": {
"type": "string",
"description": "values: [Inbound, Internal, Outbound]"
},
"attachments": {
"type": "array",
"items": {
"$ref": "#/components/schemas/File"
}
}
}
}
GenericConversation
{
"type": "object",
"required": [
"id",
"requesterId",
"channel",
"createdAt"
],
"properties": {
"id": {
"type": "integer",
"format": "int64"
},
"link": {
"$ref": "#/components/schemas/ConversationLink"
},
"queue": {
"$ref": "#/components/schemas/Queue"
},
"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]"
},
"assignment": {
"$ref": "#/components/schemas/Assignment"
},
"requesterId": {
"type": "string",
"format": "uuid"
},
"stateUpdatedAt": {
"type": "string",
"format": "date-time"
},
"customAttributes": {
"type": "array",
"items": {
"$ref": "#/components/schemas/CustomAttribute"
}
},
"toContactPointId": {
"type": "string"
},
"fromContactPointId": {
"type": "string"
}
}
}
GetActivityLogOutput
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ActivityLogEntry"
}
}
}
}
GetContactPointByIdOutput
{
"type": "object",
"required": [
"data"
],
"properties": {
"data": {
"$ref": "#/components/schemas/ContactEndpoint"
}
}
}
GetConversationOutput
{
"type": "object",
"required": [
"data"
],
"properties": {
"data": {
"$ref": "#/components/schemas/Conversation"
}
}
}
GetEndUserOutput
{
"type": "object",
"required": [
"data"
],
"properties": {
"data": {
"$ref": "#/components/schemas/EndUser"
}
}
}
GetFilterValuesOutput
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/FilterValue"
}
},
"meta": {
"$ref": "#/components/schemas/PaginationLinks"
}
}
}
GetMetricDataInput
{
"type": "object",
"required": [
"id",
"periodFilter",
"timezone"
],
"properties": {
"id": {
"type": "string"
},
"filters": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Filter"
}
},
"timezone": {
"type": "string"
},
"aggregations": {
"type": "array",
"items": {
"type": "string",
"description": "values: [Min, Max, Sum, Count, Percentage, StdDev, Average]"
}
},
"periodFilter": {
"$ref": "#/components/schemas/PeriodFilter"
}
}
}
GetMetricDataOutput
{
"type": "object",
"required": [
"data"
],
"properties": {
"data": {
"$ref": "#/components/schemas/MetricData"
}
}
}
GetMetricOutput
{
"type": "object",
"required": [
"data"
],
"properties": {
"data": {
"$ref": "#/components/schemas/MetricMetadata"
}
}
}
GetMetricRecordOutput
{
"type": "object",
"required": [
"data"
],
"properties": {
"data": {
"$ref": "#/components/schemas/MetricRecordMetadata"
}
}
}
GetMetricRecordsDataInput
{
"type": "object",
"required": [
"id",
"periodFilter",
"timezone"
],
"properties": {
"id": {
"type": "string"
},
"filters": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Filter"
}
},
"timezone": {
"type": "string"
},
"periodFilter": {
"$ref": "#/components/schemas/PeriodFilter"
}
}
}
GetMetricRecordsDataOutput
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/MetricRecord"
}
},
"meta": {
"$ref": "#/components/schemas/PaginationLinks"
}
}
}
GetMetricRecordsOutput
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/MetricRecordMetadata"
}
},
"meta": {
"$ref": "#/components/schemas/PaginationLinks"
}
}
}
GetMetricsOutput
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/MetricMetadata"
}
},
"meta": {
"$ref": "#/components/schemas/PaginationLinks"
}
}
}
GetQueueByIdOutput
{
"type": "object",
"required": [
"data"
],
"properties": {
"data": {
"$ref": "#/components/schemas/Queue1"
}
}
}
GetTagOutput
{
"type": "object",
"required": [
"data"
],
"properties": {
"data": {
"$ref": "#/components/schemas/Tag"
}
}
}
GetWebhookEventDeliveryLogsOutput
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/EventDeliveryLog"
}
}
}
}
GetWebhookLastDeliveryStatusOutput
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/EventDeliveryStatus"
}
}
}
}
GetWebhookSubscriptionOutput
{
"type": "object",
"required": [
"data"
],
"properties": {
"data": {
"$ref": "#/components/schemas/WebhookSubscription"
}
}
}
Html
{
"type": "object",
"required": [
"value"
],
"properties": {
"value": {
"type": "string"
}
}
}
Inbound
{
"type": "object",
"required": [
"content"
],
"properties": {
"content": {
"$ref": "#/components/schemas/Content"
},
"externalId": {
"type": "string",
"description": "Client generated identifier for external reference"
},
"attachments": {
"type": "array",
"items": {
"$ref": "#/components/schemas/File"
}
},
"integrationEmail": {
"type": "string",
"description": "Internal email address registered for the integration with format: \\<email-address\\>@email.dixa.io"
}
}
}
Infrastructure
{
"type": "object",
"required": [
"id",
"message"
],
"properties": {
"id": {
"type": "string"
},
"message": {
"type": "string"
}
}
}
InstantField
{
"type": "object",
"required": [
"value"
],
"properties": {
"value": {
"type": "string",
"format": "date-time"
}
}
}
IntField
{
"type": "object",
"required": [
"value"
],
"properties": {
"value": {
"type": "integer",
"format": "int32"
}
}
}
Integrity
{
"type": "object",
"required": [
"id",
"message"
],
"properties": {
"id": {
"type": "string"
},
"message": {
"type": "string"
}
}
}
InternalNoteData
{
"type": "object",
"required": [
"id",
"authorId",
"createdAt",
"csid",
"message"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"csid": {
"type": "integer",
"format": "int64"
},
"message": {
"type": "string"
},
"authorId": {
"type": "string",
"format": "uuid"
},
"createdAt": {
"type": "string",
"format": "date-time"
}
}
}
Interval
{
"type": "object",
"required": [
"start",
"end"
],
"properties": {
"end": {
"type": "string",
"format": "date-time"
},
"start": {
"type": "string",
"format": "date-time"
}
}
}
ListActivityLogOutput
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ActivityLogEntry"
}
},
"meta": {
"$ref": "#/components/schemas/PaginationLinks"
}
}
}
ListAgentsOutput
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Agent"
}
},
"meta": {
"$ref": "#/components/schemas/PaginationLinks"
}
}
}
ListContactPointsOutput
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ContactEndpoint"
}
}
}
}
ListConversationRatingsOutput
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ConversationRating"
}
}
}
}
ListCustomAttributesDefinitionsOutput
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/CustomAttributeDefinition"
}
}
}
}
ListEndUserConversationsOutput
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Conversation"
}
},
"meta": {
"$ref": "#/components/schemas/PaginationLinks"
}
}
}
ListEndUsersOutput
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/EndUser"
}
},
"meta": {
"$ref": "#/components/schemas/PaginationLinks"
}
}
}
ListField
{
"type": "object",
"properties": {
"values": {
"type": "array",
"items": {
"$ref": "#/components/schemas/PrimitiveField"
}
}
}
}
ListFlowsOutput
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ConversationFlow"
}
}
}
}
ListInternalNotesOutput
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/InternalNoteData"
}
}
}
}
ListLinkedConversationsOutput
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Conversation"
}
}
}
}
ListMessagesOutput
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Message"
}
}
}
}
ListPresenceOutput
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/UserPresence"
}
},
"meta": {
"$ref": "#/components/schemas/PaginationLinks"
}
}
}
ListQueuesOutput
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Queue1"
}
}
}
}
ListTagsOutput
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Tag"
}
}
}
}
ListTeamMembersOutput
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/TeamMember"
}
}
}
}
ListTeamsOutput
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Team1"
}
}
}
}
ListWebhookSubscriptionsEndpointOutput
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/WebhookSubscription"
}
}
}
}
LongAggregateValue
{
"type": "object",
"required": [
"value",
"measure"
],
"properties": {
"value": {
"type": "integer",
"format": "int64"
},
"measure": {
"type": "string",
"description": "values: [Count]"
}
}
}
LongField
{
"type": "object",
"required": [
"value"
],
"properties": {
"value": {
"type": "integer",
"format": "int64"
}
}
}
Map_ConversationChannel_Int
{
"type": "object",
"description": "values: [WhatsApp, Voicemail, WidgetChat, FacebookMessenger, Twitter, Email, ContactForm, Callback, PstnPhone, Sms, Messenger]",
"additionalProperties": {
"type": "integer",
"format": "int32"
}
}
Map_ConversationChannel_Set_String
{
"type": "object",
"description": "values: [WhatsApp, Voicemail, WidgetChat, FacebookMessenger, Twitter, Email, ContactForm, Callback, PstnPhone, Sms, Messenger]",
"additionalProperties": {
"type": "array",
"items": {
"type": "string"
}
}
}
Map_QueueThreshold_Int
{
"type": "object",
"description": "values: [SlaTimeLimit, AvailableAgents, LongestWait, SlaPercentage, WaitingConversations]",
"additionalProperties": {
"type": "integer",
"format": "int32"
}
}
Map_String
{
"type": "object",
"additionalProperties": {
"type": "string"
}
}
Map_UUID_Option_AttributeValue
{
"type": "object",
"additionalProperties": {
"oneOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "string"
}
],
"description": "AttributeValue values: String[] if the type of the custom attribute is Select or String if the type of the custom attribute is Text"
}
}
Map_Vector_String
{
"type": "object",
"description": "Snippet of text where a match was found. Matched text will be wrapped in \\<em\\> tags.",
"additionalProperties": {
"type": "array",
"items": {
"type": "string"
}
}
}
Message
{
"type": "object",
"required": [
"id",
"authorId",
"createdAt",
"attributes"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"authorId": {
"type": "string",
"format": "uuid"
},
"createdAt": {
"type": "string",
"format": "date-time"
},
"attributes": {
"$ref": "#/components/schemas/Attributes"
},
"externalId": {
"type": "string"
}
}
}
MessageAddedAttribute
{
"type": "object",
"required": [
"messageId"
],
"properties": {
"avatarUrl": {
"type": "string"
},
"messageId": {
"type": "string"
},
"fromEndpoint": {
"type": "string"
}
}
}
MessageAddedByAgentActivityType
{
"type": "object"
}
MessageAddedByCustomerActivityType
{
"type": "object"
}
MessageAnonymizationType
{
"type": "object"
}
MessengerConversation
{
"type": "object",
"required": [
"id",
"requesterId",
"channel",
"createdAt"
],
"properties": {
"id": {
"type": "integer",
"format": "int64"
},
"link": {
"$ref": "#/components/schemas/ConversationLink"
},
"queue": {
"$ref": "#/components/schemas/Queue"
},
"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]"
},
"language": {
"type": "string"
},
"createdAt": {
"type": "string",
"format": "date-time"
},
"direction": {
"type": "string",
"description": "values: [Inbound, Internal, Outbound]"
},
"assignment": {
"$ref": "#/components/schemas/Assignment"
},
"requesterId": {
"type": "string",
"format": "uuid"
},
"stateUpdatedAt": {
"type": "string",
"format": "date-time"
},
"customAttributes": {
"type": "array",
"items": {
"$ref": "#/components/schemas/CustomAttribute"
}
}
}
}
MetricData
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string"
},
"aggregates": {
"type": "array",
"items": {
"$ref": "#/components/schemas/AggregateValue"
}
}
}
}
MetricMetadata
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The metric ID"
},
"filters": {
"type": "array",
"items": {
"$ref": "#/components/schemas/FilterMetadata"
},
"description": "List of available filters that can be used when fetching metric data"
},
"description": {
"type": "string",
"description": "Relevant information about the metric"
},
"aggregations": {
"type": "array",
"items": {
"$ref": "#/components/schemas/AggregateMetadata"
},
"description": "List of available aggregations that can be used when fetching metric data"
},
"relatedRecordIds": {
"type": "array",
"items": {
"type": "string"
},
"description": "List of record IDs used to compose the metric"
}
}
}
MetricRecord
{
"type": "object",
"required": [
"primaryTimestampField"
],
"properties": {
"value": {
"$ref": "#/components/schemas/FieldType"
},
"fields": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Field"
}
},
"primaryTimestampField": {
"$ref": "#/components/schemas/TimestampField"
}
}
}
MetricRecordMetadata
{
"type": "object",
"required": [
"id",
"description"
],
"properties": {
"id": {
"type": "string",
"description": "The record ID"
},
"filters": {
"type": "array",
"items": {
"$ref": "#/components/schemas/FilterMetadata"
},
"description": "List of available filters that can be used when fetching record data"
},
"description": {
"type": "string",
"description": "Relevant information about the record"
},
"fieldsMetadata": {
"type": "array",
"items": {
"$ref": "#/components/schemas/FieldMetadata"
},
"description": "Information about the individual record fields"
},
"relatedMetricIds": {
"type": "array",
"items": {
"type": "string"
},
"description": "List of metric IDs that make use of this record"
}
}
}
NoAuth
{
"type": "object"
}
NoRecentDelivery
{
"type": "object"
}
NotFound
{
"type": "object",
"required": [
"message"
],
"properties": {
"message": {
"type": "string"
}
}
}
NotFound1
{
"type": "object",
"required": [
"id",
"message"
],
"properties": {
"id": {
"type": "string"
},
"message": {
"type": "string"
}
}
}
NoteAddedActivityType
{
"type": "object"
}
NoteAddedAttribute
{
"type": "object",
"required": [
"message"
],
"properties": {
"message": {
"type": "string"
},
"avatarUrl": {
"type": "string"
}
}
}
Outbound
{
"type": "object",
"required": [
"content",
"agentId"
],
"properties": {
"cc": {
"type": "array",
"items": {
"type": "string",
"format": "uuid"
}
},
"bcc": {
"type": "array",
"items": {
"type": "string",
"format": "uuid"
}
},
"agentId": {
"type": "string",
"format": "uuid"
},
"content": {
"$ref": "#/components/schemas/Content"
},
"externalId": {
"type": "string"
},
"attachments": {
"type": "array",
"items": {
"$ref": "#/components/schemas/File"
}
},
"integrationEmail": {
"type": "string"
}
}
}
PaginationLinks
{
"type": "object",
"properties": {
"next": {
"type": "string",
"description": "url"
},
"previous": {
"type": "string",
"description": "url"
}
}
}
PatchAgentInput
{
"type": "object",
"properties": {
"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"
}
}
}
PatchConversationCustomAttributesOutput
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/CustomAttribute"
}
}
}
}
PatchEndUserCustomAttributesOutput
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/CustomAttribute"
}
}
}
}
PatchEndUserInput
{
"type": "object",
"properties": {
"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"
}
}
}
}
PatchEndUserOutput
{
"type": "object",
"required": [
"data"
],
"properties": {
"data": {
"$ref": "#/components/schemas/EndUser"
}
}
}
PatchWebhookSubscriptionInput
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "URL of the server that the webhook request should be sent to"
},
"name": {
"type": "string",
"description": "The Webhook Subscription name"
},
"events": {
"type": "array",
"items": {
"type": "string",
"description": "values: [ConversationPending, AgentUnbannedEnduser, ConversationMessageAdded, ConversationTagAdded, AgentBannedIp, ConversationAssigned, ConversationPendingExpired, ConversationTransferred, ConversationEnqueued, ConversationCreated, ConversationUnassigned, ConversationOpen, ConversationAbandoned, ConversationClosed, ConversationNoteAdded, AgentBannedEnduser, ConversationEndUserReplaced, AgentUnbannedIp, ConversationTagRemoved, ConversationRated]"
},
"description": "The set of events this Webhook Subscription subscribes to. Allowed values: [ConversationPending, AgentUnbannedEnduser, ConversationMessageAdded, ConversationTagAdded, AgentBannedIp, ConversationAssigned, ConversationPendingExpired, ConversationTransferred, ConversationEnqueued, ConversationCreated, ConversationUnassigned, ConversationOpen, ConversationAbandoned, ConversationClosed, ConversationNoteAdded, AgentBannedEnduser, ConversationEndUserReplaced, AgentUnbannedIp, ConversationTagRemoved, ConversationRated]"
},
"enabled": {
"type": "boolean",
"description": "Defines whether this Webhook Subscription is enabled or disabled"
},
"authorization": {
"$ref": "#/components/schemas/WebhookAuthorization"
}
}
}
PatchWebhookSubscriptionOutput
{
"type": "object",
"required": [
"data"
],
"properties": {
"data": {
"$ref": "#/components/schemas/WebhookSubscription"
}
}
}
PeriodFilter
{
"oneOf": [
{
"$ref": "#/components/schemas/Interval"
},
{
"$ref": "#/components/schemas/Preset"
}
]
}
PhoneAttributes
{
"type": "object",
"required": [
"from",
"to"
],
"properties": {
"to": {
"type": "string"
},
"from": {
"type": "string"
},
"duration": {
"type": "integer",
"format": "int32"
},
"direction": {
"type": "string",
"description": "values: [Inbound, Internal, Outbound]"
}
}
}
Preset
{
"type": "object",
"required": [
"value"
],
"properties": {
"value": {
"type": "string",
"description": "values: [PreviousQuarter, ThisWeek, PreviousWeek, Yesterday, Today, ThisMonth, PreviousMonth, ThisQuarter, ThisYear]"
}
}
}
PrimitiveField
{
"oneOf": [
{
"$ref": "#/components/schemas/BooleanField"
},
{
"$ref": "#/components/schemas/DoubleField"
},
{
"$ref": "#/components/schemas/InstantField"
},
{
"$ref": "#/components/schemas/IntField"
},
{
"$ref": "#/components/schemas/LongField"
},
{
"$ref": "#/components/schemas/StringField"
},
{
"$ref": "#/components/schemas/UUIDField"
}
]
}
PstnPhoneConversation
{
"type": "object",
"required": [
"id",
"requesterId",
"channel",
"createdAt"
],
"properties": {
"id": {
"type": "integer",
"format": "int64"
},
"link": {
"$ref": "#/components/schemas/ConversationLink"
},
"queue": {
"$ref": "#/components/schemas/Queue"
},
"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]"
},
"assignment": {
"$ref": "#/components/schemas/Assignment"
},
"requesterId": {
"type": "string",
"format": "uuid"
},
"stateUpdatedAt": {
"type": "string",
"format": "date-time"
},
"customAttributes": {
"type": "array",
"items": {
"$ref": "#/components/schemas/CustomAttribute"
}
}
}
}
Queue
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"queuedAt": {
"type": "string",
"format": "date-time"
}
}
}
Queue1
{
"type": "object",
"required": [
"id",
"name",
"isDefault",
"organizationId",
"queueThresholds",
"slaCalculationMethod",
"doNotOfferTimeouts",
"isDoNotOfferEnabled"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"usages": {
"$ref": "#/components/schemas/QueueUsages"
},
"priority": {
"type": "integer",
"format": "int32"
},
"isDefault": {
"type": "boolean"
},
"offerTimeout": {
"type": "integer",
"format": "int32"
},
"wrapupTimeout": {
"type": "integer",
"format": "int32"
},
"memberListType": {
"type": "string",
"description": "values: [Default, SkillBased]"
},
"organizationId": {
"type": "string"
},
"queueThresholds": {
"$ref": "#/components/schemas/Map_QueueThreshold_Int"
},
"offeringAlgorithm": {
"type": "string",
"description": "values: [AgentPriorityOneAtATimeRandom, AllAtOnce, AgentPriorityLongestIdle, AgentPriorityAllAtOnce, LongestIdle, OneAtATimeRandom]"
},
"doNotOfferTimeouts": {
"$ref": "#/components/schemas/Map_ConversationChannel_Int"
},
"isDoNotOfferEnabled": {
"type": "boolean"
},
"slaCalculationMethod": {
"type": "string",
"description": "values: [AbandonedIgnored]"
},
"preferredAgentTimeouts": {
"$ref": "#/components/schemas/Map_ConversationChannel_Int"
},
"isPreferredAgentEnabled": {
"type": "boolean"
},
"offerAbandonedConversations": {
"type": "boolean"
},
"personalAgentOfflineTimeout": {
"type": "integer",
"format": "int32"
},
"preferredAgentOfflineTimeout": {
"type": "integer",
"format": "int32"
}
}
}
QueueMember
{
"type": "object",
"required": [
"agentId"
],
"properties": {
"agentId": {
"type": "string"
},
"priority": {
"type": "integer",
"format": "int32"
}
}
}
QueueMembersOutput
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/QueueMember"
}
}
}
}
QueueUsages
{
"type": "object",
"required": [
"queueId",
"usages"
],
"properties": {
"usages": {
"$ref": "#/components/schemas/Map_ConversationChannel_Set_String"
},
"queueId": {
"type": "string"
}
}
}
Regular
{
"type": "object",
"required": [
"content"
],
"properties": {
"content": {
"$ref": "#/components/schemas/Content"
}
}
}
ReopenConversationInput
{
"type": "object",
"properties": {
"userId": {
"type": "string",
"format": "uuid"
}
}
}
SearchHit
{
"oneOf": [
{
"$ref": "#/components/schemas/ConversationSearchHit"
}
]
}
SearchOutput
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/SearchHit"
}
},
"meta": {
"$ref": "#/components/schemas/PaginationLinks"
}
}
}
Select
{
"type": "object",
"properties": {
"options": {
"type": "array",
"items": {
"$ref": "#/components/schemas/SelectOption"
}
}
}
}
SelectOption
{
"type": "object",
"required": [
"id",
"label",
"value",
"isDeactivated"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"label": {
"type": "string"
},
"value": {
"type": "string"
},
"isDeactivated": {
"type": "boolean"
},
"nestedOptions": {
"type": "array",
"items": {
"$ref": "#/components/schemas/SelectOption"
}
}
}
}
ServerError
{
"type": "object",
"required": [
"message"
],
"properties": {
"message": {
"type": "string"
}
}
}
SideConversation
{
"type": "object",
"required": [
"parentId"
],
"properties": {
"parentId": {
"type": "integer",
"format": "int64"
}
}
}
Sms
{
"type": "object",
"required": [
"requesterId",
"contactEndpointId",
"message"
],
"properties": {
"message": {
"$ref": "#/components/schemas/CreateMessageInput"
},
"requesterId": {
"type": "string",
"format": "uuid"
},
"contactEndpointId": {
"type": "string",
"description": "SMS enabled provisioned phone number in valid E.164 format"
}
}
}
SmsAttributes
{
"type": "object",
"properties": {
"content": {
"$ref": "#/components/schemas/Content"
},
"direction": {
"type": "string",
"description": "values: [Inbound, Internal, Outbound]"
},
"attachments": {
"type": "array",
"items": {
"$ref": "#/components/schemas/File"
}
}
}
}
SmsConversation
{
"type": "object",
"required": [
"id",
"requesterId",
"channel",
"createdAt"
],
"properties": {
"id": {
"type": "integer",
"format": "int64"
},
"link": {
"$ref": "#/components/schemas/ConversationLink"
},
"queue": {
"$ref": "#/components/schemas/Queue"
},
"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]"
},
"toNumber": {
"type": "string"
},
"createdAt": {
"type": "string",
"format": "date-time"
},
"direction": {
"type": "string",
"description": "values: [Inbound, Internal, Outbound]"
},
"assignment": {
"$ref": "#/components/schemas/Assignment"
},
"fromNumber": {
"type": "string"
},
"requesterId": {
"type": "string",
"format": "uuid"
},
"stateUpdatedAt": {
"type": "string",
"format": "date-time"
},
"customAttributes": {
"type": "array",
"items": {
"$ref": "#/components/schemas/CustomAttribute"
}
}
}
}
StringField
{
"type": "object",
"required": [
"value"
],
"properties": {
"label": {
"type": "string"
},
"value": {
"type": "string"
}
}
}
Tag
{
"type": "object",
"required": [
"id",
"name",
"state"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"name": {
"type": "string"
},
"color": {
"type": "string"
},
"state": {
"type": "string",
"description": "values: [Active, Inactive]"
}
}
}
TagAddedActivityType
{
"type": "object"
}
TagAddedAttribute
{
"type": "object",
"required": [
"tag"
],
"properties": {
"tag": {
"type": "string"
}
}
}
TagRemovedActivityType
{
"type": "object"
}
TagRemovedAttribute
{
"type": "object",
"required": [
"tag"
],
"properties": {
"tag": {
"type": "string"
}
}
}
Team
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
}
}
}
Team1
{
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
}
}
TeamMember
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"email": {
"type": "string"
},
"phoneNumber": {
"type": "string"
}
}
}
TelephonyEndpoint
{
"type": "object",
"required": [
"number"
],
"properties": {
"name": {
"type": "string"
},
"number": {
"type": "string"
},
"functionality": {
"type": "array",
"items": {
"type": "string",
"description": "values: [Sms, VoiceInbound, VoiceOutbound]"
}
}
}
}
Text
{
"type": "object",
"required": [
"value"
],
"properties": {
"value": {
"type": "string"
}
}
}
Text1
{
"type": "object",
"properties": {
"placeholder": {
"type": "string"
}
}
}
TimestampField
{
"type": "object",
"required": [
"name",
"timestamp"
],
"properties": {
"name": {
"type": "string"
},
"timestamp": {
"type": "string",
"format": "date-time"
}
}
}
TokenAuth
{
"type": "object",
"required": [
"value"
],
"properties": {
"value": {
"type": "string",
"description": "Token value. It will be added in the headers of the request as: 'Authorization': 'Bearer \\<value\\>'"
}
}
}
TooLarge
{
"type": "object",
"required": [
"file"
],
"properties": {
"file": {
"$ref": "#/components/schemas/File"
}
}
}
TransferConversationInput
{
"type": "object",
"required": [
"queueId"
],
"properties": {
"userId": {
"type": "string",
"format": "uuid",
"description": "An optional agent/admin to originate the transfer of the conversation"
},
"queueId": {
"type": "string",
"format": "uuid",
"description": "The target queue for the conversation transfer"
}
}
}
TransferFailedActivityType
{
"type": "object"
}
TransferInitiatedActivityType
{
"type": "object"
}
TransferSuccessfulActivityType
{
"type": "object"
}
TwitterAttributes
{
"type": "object",
"properties": {
"content": {
"$ref": "#/components/schemas/Content"
},
"direction": {
"type": "string",
"description": "values: [Inbound, Internal, Outbound]"
},
"attachments": {
"type": "array",
"items": {
"$ref": "#/components/schemas/File"
}
}
}
}
TwitterConversation
{
"type": "object",
"required": [
"id",
"requesterId",
"channel",
"createdAt",
"conversationType"
],
"properties": {
"id": {
"type": "integer",
"format": "int64"
},
"link": {
"$ref": "#/components/schemas/ConversationLink"
},
"queue": {
"$ref": "#/components/schemas/Queue"
},
"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]"
},
"assignment": {
"$ref": "#/components/schemas/Assignment"
},
"requesterId": {
"type": "string",
"format": "uuid"
},
"stateUpdatedAt": {
"type": "string",
"format": "date-time"
},
"conversationType": {
"type": "string",
"description": "values: [DirectMessage, Tweet]"
},
"customAttributes": {
"type": "array",
"items": {
"$ref": "#/components/schemas/CustomAttribute"
}
},
"endUserTwitterId": {
"type": "string"
},
"contactPointTwitterId": {
"type": "string"
}
}
}
UUIDField
{
"type": "object",
"required": [
"value"
],
"properties": {
"label": {
"type": "string"
},
"value": {
"type": "string",
"format": "uuid"
}
}
}
Unauthorized
{
"type": "object",
"required": [
"message"
],
"properties": {
"message": {
"type": "string"
}
}
}
UnknownActivityType
{
"type": "object"
}
UnknownAnonymizationType
{
"type": "object"
}
UpdateAgentInput
{
"type": "object",
"required": [
"displayName"
],
"properties": {
"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"
}
}
}
UpdateEndUserInput
{
"type": "object",
"required": [
"displayName"
],
"properties": {
"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"
}
}
}
}
UpdateEndUserOutput
{
"type": "object",
"required": [
"data"
],
"properties": {
"data": {
"$ref": "#/components/schemas/EndUser"
}
}
}
UserAnonymizationType
{
"type": "object"
}
UserPresence
{
"type": "object",
"required": [
"userId",
"requestTime",
"connectionStatus"
],
"properties": {
"userId": {
"type": "string"
},
"lastSeen": {
"type": "string"
},
"requestTime": {
"type": "string"
},
"activeChannels": {
"type": "array",
"items": {
"type": "string",
"description": "values: [WhatsApp, Voicemail, WidgetChat, FacebookMessenger, Twitter, Email, ContactForm, Callback, PstnPhone, Sms, Messenger]"
}
},
"presenceStatus": {
"type": "string",
"description": "values: [Away, Working]"
},
"connectionStatus": {
"type": "string",
"description": "values: [Offline, Online]"
}
}
}
UserPresenceOutput
{
"type": "object",
"required": [
"data"
],
"properties": {
"data": {
"$ref": "#/components/schemas/UserPresence"
}
}
}
Validation
{
"type": "object",
"required": [
"message"
],
"properties": {
"id": {
"type": "string"
},
"message": {
"type": "string"
}
}
}
WebhookAuthorization
{
"oneOf": [
{
"$ref": "#/components/schemas/BasicAuth"
},
{
"$ref": "#/components/schemas/NoAuth"
},
{
"$ref": "#/components/schemas/TokenAuth"
}
],
"description": "Authorization to be added as a header in the webhook request. Can be either, Basic auth, added as 'Basic base64encoded(\\<username\\>:\\<password\\>)', Token auth, added as 'Bearer \\<token value\\>', or no auth"
}
WebhookSubscription
{
"type": "object",
"required": [
"id",
"name",
"url",
"headers",
"secretKey",
"enabled",
"createdAt",
"createdBy",
"updatedAt",
"updatedBy"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "The Webhook Subscription ID"
},
"url": {
"type": "string",
"description": "URL of the server that the webhook request should be sent to"
},
"name": {
"type": "string",
"description": "The Webhook Subscription name"
},
"enabled": {
"type": "boolean",
"description": "Defines whether this Webhook Subscription is enabled or disabled"
},
"headers": {
"$ref": "#/components/schemas/Webhook_Headers_Map_String_String"
},
"createdAt": {
"type": "string",
"format": "date-time",
"description": "Date when this Webhook Subscription was created"
},
"createdBy": {
"type": "string",
"format": "uuid",
"description": "The ID of the user who created this Webhook Subscription"
},
"secretKey": {
"type": "string",
"description": "Dixa generated secret key, used to sign the requests"
},
"updatedAt": {
"type": "string",
"format": "date-time",
"description": "Date when this Webhook Subscription was last updated"
},
"updatedBy": {
"type": "string",
"format": "uuid",
"description": "The ID of the user who last updated this Webhook Subscription"
},
"subscribedEvents": {
"type": "array",
"items": {
"type": "string",
"description": "values: [ConversationPending, AgentUnbannedEnduser, ConversationMessageAdded, ConversationTagAdded, AgentBannedIp, ConversationAssigned, ConversationPendingExpired, ConversationTransferred, ConversationEnqueued, ConversationCreated, ConversationUnassigned, ConversationOpen, ConversationAbandoned, ConversationClosed, ConversationNoteAdded, AgentBannedEnduser, ConversationEndUserReplaced, AgentUnbannedIp, ConversationTagRemoved, ConversationRated]"
},
"description": "The set of events this Webhook Subscription is subscribed to"
}
}
}
Webhook_Headers_Map_String_String
{
"type": "object",
"description": "The headers that will be added to the webhook request",
"additionalProperties": {
"type": "string"
}
}
WhatsAppAttributes
{
"type": "object",
"properties": {
"content": {
"$ref": "#/components/schemas/Content"
},
"direction": {
"type": "string",
"description": "values: [Inbound, Internal, Outbound]"
},
"attachments": {
"type": "array",
"items": {
"$ref": "#/components/schemas/File"
}
}
}
}
WhatsAppConversation
{
"type": "object",
"required": [
"id",
"requesterId",
"channel",
"createdAt"
],
"properties": {
"id": {
"type": "integer",
"format": "int64"
},
"link": {
"$ref": "#/components/schemas/ConversationLink"
},
"queue": {
"$ref": "#/components/schemas/Queue"
},
"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]"
},
"assignment": {
"$ref": "#/components/schemas/Assignment"
},
"requesterId": {
"type": "string",
"format": "uuid"
},
"stateUpdatedAt": {
"type": "string",
"format": "date-time"
},
"customAttributes": {
"type": "array",
"items": {
"$ref": "#/components/schemas/CustomAttribute"
}
}
}
}