Query structured spec data via REST or MCP. Get exactly what your agent needs.
https://dev.dixa.io
/v1/agents
Bulk update agents/admins.
The list of agent/admin update actions
application/json
AgentsUpdateBulkRequest
of object
| Property | Type | Required |
|---|---|---|
| id | string | required |
| lastName | string | optional |
| avatarUrl | string | optional |
| firstName | string | optional |
| displayName | string | required |
| middleNames | array | optional |
| phoneNumber | string | optional |
| additionalEmails | array | optional |
| additionalPhoneNumbers | array | optional |
The list of update action outcomes
Invalid value extracted from request context, Invalid value for: body
Internal failure during request processing
PUT /v1/agents
/v1/agents/{agentId}
Update an agent/admin.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| agentId | path | required | string | The agent id |
The updated details for an agent/admin
application/json
UpdateAgentInput
| Property | Type | Required |
|---|---|---|
| lastName | string | optional |
| avatarUrl | string | optional |
| firstName | string | optional |
| displayName | string | required |
| middleNames | array | optional |
| phoneNumber | string | optional |
| additionalEmails | array | optional |
| additionalPhoneNumbers | array | optional |
The updated agent/admin
Invalid value for: path parameter agentId, Invalid value extracted from request context, Invalid value for: body, Validation failure during update
An entity in this request could not be found
Internal failure during request processing
PUT /v1/agents/{agentId}
/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 | — |
application/json
ClaimConversationInput
| Property | Type | Required |
|---|---|---|
| force | boolean | optional |
| agentId | string | required |
The conversation was successfully claimed
Invalid value for: path parameter conversationId, Invalid value extracted from request context, Invalid value for: body
An entity in this request could not be found
Internal failure during request processing
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 | — |
An optional agent/admin to close the conversation
application/json
CloseConversationInput
| Property | Type | Required |
|---|---|---|
| userId | string | optional |
The conversation was successfully closed
Invalid value for: path parameter conversationId, Invalid value extracted from request context, Invalid value for: body, User not found, User is not agent/admin
An entity in this request could not be found
PUT /v1/conversations/{conversationId}/close
/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 | — |
An optional agent/admin to reopen the conversation
application/json
ReopenConversationInput
| Property | Type | Required |
|---|---|---|
| userId | string | optional |
The conversation was successfully reopened and offered in the same queue
Invalid value for: path parameter conversationId, Invalid value extracted from request context, Invalid value for: body, User not found, User is not agent/admin
An entity in this request could not be found
Internal failure during request processing
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 | — |
Transfer conversation request
application/json
TransferConversationInput
| Property | Type | Required |
|---|---|---|
| userId | string | optional |
| queueId | string | required |
The conversation was successfully transferred to the target queue
Invalid value for: path parameter conversationId, Invalid value extracted from request context, Invalid value for: body, User not found, User is not agent/admin, Queue does not exist
An entity in this request could not be found
Internal failure during request processing
PUT /v1/conversations/{conversationId}/transfer/queue
/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 | — |
The conversation was successfully tagged
Invalid value for: path parameter conversationId, Invalid value for: path parameter tagId, Invalid value extracted from request context
An entity in this request could not be found
Internal failure during request processing
PUT /v1/conversations/{conversationId}/tags/{tagId}
/v1/endusers
Bulk update end users.
List of end user update actions
application/json
BulkUpdateEndUsersInput
| Property | Type | Required |
|---|---|---|
| data | array | optional |
| └ id | string | required |
| string | optional | |
| └ lastName | string | optional |
| └ avatarUrl | string | optional |
| └ firstName | string | optional |
| └ externalId | string | optional |
| └ displayName | string | required |
| └ middleNames | array | optional |
| └ phoneNumber | string | optional |
| └ additionalEmails | array | optional |
| └ additionalPhoneNumbers | array | optional |
The updated end users
Invalid value extracted from request context, Invalid value for: body
Internal failure during request processing
PUT /v1/endusers
/v1/endusers/{userId}
Update an end user.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| userId | path | required | string | The end user id |
The updated details for an end user
application/json
UpdateEndUserInput
| Property | Type | Required |
|---|---|---|
| string | optional | |
| lastName | string | optional |
| avatarUrl | string | optional |
| firstName | string | optional |
| externalId | string | optional |
| displayName | string | required |
| middleNames | array | optional |
| phoneNumber | string | optional |
| additionalEmails | array | optional |
| additionalPhoneNumbers | array | optional |
The updated end user
Invalid value for: path parameter userId, Invalid value extracted from request context, Invalid value for: body, Validation failure during update
An entity in this request could not be found
Internal failure during request processing
PUT /v1/endusers/{userId}
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"
}
}
}