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"
}
}
}
}