# Conversations ## Close conversation - [PUT /beta/conversations/{conversationId}/close](https://docs.dixa.io/openapi/dixa-api/beta/chatbots/putconversationsconversationidclose.md): Mark a conversation as closed by providing its id. ## Followup conversation - [PUT /beta/conversations/{conversationId}/followup](https://docs.dixa.io/openapi/dixa-api/beta/chatbots/putconversationsconversationidfollowup.md): Follow up a conversation by providing its id and expiration timestamp. ## Transfer conversation - [PUT /beta/conversations/{conversationId}/transfer/queue](https://docs.dixa.io/openapi/dixa-api/beta/chatbots/putconversationsconversationidtransferqueue.md): Transfer a conversation to a target queue. ## Create conversation rating result - [POST /beta/conversations/{conversationId}/ratings/{ratingId}/submit](https://docs.dixa.io/openapi/dixa-api/beta/chatbots/postconversationsconversationidratingsratingidsubmit.md): Create a rating result for a specific conversation. ## Create conversation rating offer - [POST /beta/conversations/{conversationId}/ratings/offer](https://docs.dixa.io/openapi/dixa-api/beta/chatbots/postconversationsconversationidratingsoffer.md): Create a rating offer for a specific conversation. ## Create conversation - [POST /beta/conversations](https://docs.dixa.io/openapi/dixa-api/beta/chatbots/postconversations.md): 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. ## Import conversation - [POST /beta/conversations/import](https://docs.dixa.io/openapi/dixa-api/beta/chatbots/postconversationsimport.md): Import a previously created conversation into Dixa. For inbound messages the author is assumed to be the requester of the conversation (end user), unless the specific channel supports overriding the message author through its attributes. For outbound messages the author is specified using the agentId field. ## Claim conversation - [PUT /beta/conversations/{conversationId}/claim](https://docs.dixa.io/openapi/dixa-api/beta/chatbots/putconversationsconversationidclaim.md): Claim a conversation for a given agent. To avoid taking over assigned conversations, set the force paremeter to false ## Anonymize conversation - [PATCH /beta/conversations/{conversationId}/anonymize](https://docs.dixa.io/openapi/dixa-api/beta/anonymization/patchconversationsconversationidanonymize.md): Request the anonymization of a conversation. ## Anonymize message - [PATCH /beta/conversations/{conversationId}/messages/{messageId}/anonymize](https://docs.dixa.io/openapi/dixa-api/beta/anonymization/patchconversationsconversationidmessagesmessageidanonymize.md): Request the anonymization of a single message in a conversation. ## Patch conversation custom attributes - [PATCH /beta/conversations/{conversationId}/custom-attributes](https://docs.dixa.io/openapi/dixa-api/beta/custom-attributes/patchconversationsconversationidcustom-attributes.md): Patch custom attributes of a conversation ## Anonymize conversation - [PATCH /beta/conversations/{conversationId}/anonymize](https://docs.dixa.io/openapi/dixa-api/beta/conversations/patchconversationsconversationidanonymize.md): Request the anonymization of a conversation. ## Anonymize message - [PATCH /beta/conversations/{conversationId}/messages/{messageId}/anonymize](https://docs.dixa.io/openapi/dixa-api/beta/conversations/patchconversationsconversationidmessagesmessageidanonymize.md): Request the anonymization of a single message in a conversation. ## Close conversation - [PUT /beta/conversations/{conversationId}/close](https://docs.dixa.io/openapi/dixa-api/beta/conversations/putconversationsconversationidclose.md): Mark a conversation as closed by providing its id. ## Followup conversation - [PUT /beta/conversations/{conversationId}/followup](https://docs.dixa.io/openapi/dixa-api/beta/conversations/putconversationsconversationidfollowup.md): Follow up a conversation by providing its id and expiration timestamp. ## Reopen conversation - [PUT /beta/conversations/{conversationId}/reopen](https://docs.dixa.io/openapi/dixa-api/beta/conversations/putconversationsconversationidreopen.md): Reopen a conversation and offer it in the same queue. Falls back to the default organization queue if the conversation has no target queue. ## Transfer conversation - [PUT /beta/conversations/{conversationId}/transfer/queue](https://docs.dixa.io/openapi/dixa-api/beta/conversations/putconversationsconversationidtransferqueue.md): Transfer a conversation to a target queue. ## Add internal notes - [POST /beta/conversations/{conversationId}/notes/bulk](https://docs.dixa.io/openapi/dixa-api/beta/conversations/postconversationsconversationidnotesbulk.md): Create internal notes in a conversation by providing the conversation id. ## List internal notes - [GET /beta/conversations/{conversationId}/notes](https://docs.dixa.io/openapi/dixa-api/beta/conversations/getconversationsconversationidnotes.md): Get all internal notes for a particular conversation by providing the conversation id. ## Add internal note - [POST /beta/conversations/{conversationId}/notes](https://docs.dixa.io/openapi/dixa-api/beta/conversations/postconversationsconversationidnotes.md): Create an internal note in a conversation by providing the conversation id. ## Create conversation rating result - [POST /beta/conversations/{conversationId}/ratings/{ratingId}/submit](https://docs.dixa.io/openapi/dixa-api/beta/conversations/postconversationsconversationidratingsratingidsubmit.md): Create a rating result for a specific conversation. ## Create conversation rating offer - [POST /beta/conversations/{conversationId}/ratings/offer](https://docs.dixa.io/openapi/dixa-api/beta/conversations/postconversationsconversationidratingsoffer.md): Create a rating offer for a specific conversation. ## List ratings for a conversation - [GET /beta/conversations/{conversationId}/ratings](https://docs.dixa.io/openapi/dixa-api/beta/conversations/getconversationsconversationidratings.md): Lists latest ratings statuses for a particular conversation by providing the conversation ID. For surveys with multiple questions, rating status will be reported for each individual question of the survey. For example, a response for a 3 question survey that was answered will be 3 elements with status "Rated". Additionally, a multiple question survey can be partially answered, therefore a response of such case will be a mix of "Offered" and "Rated" statuses. Note that the IDs of multiple questions response elements will be the same, because they are part of the same survey. ## List organization activity log - [GET /beta/conversations/activitylog](https://docs.dixa.io/openapi/dixa-api/beta/conversations/getconversationsactivitylog.md): List all activity logs for an organization. ## List flows - [GET /beta/conversations/flows](https://docs.dixa.io/openapi/dixa-api/beta/conversations/getconversationsflows.md): List all conversations flows in an organization. ## Tag conversation - [PUT /beta/conversations/{conversationId}/tags/{tagId}](https://docs.dixa.io/openapi/dixa-api/beta/conversations/putconversationsconversationidtagstagid.md): Tag a conversation. You may only use active tags to tag conversations. ## Untag conversation - [DELETE /beta/conversations/{conversationId}/tags/{tagId}](https://docs.dixa.io/openapi/dixa-api/beta/conversations/deleteconversationsconversationidtagstagid.md): Untag a conversation. You may remove active or inactive tags from a conversation. ## Bulk tag conversation - [POST /beta/conversations/{conversationId}/tags/bulk](https://docs.dixa.io/openapi/dixa-api/beta/conversations/postconversationsconversationidtagsbulk.md): Initiate bulk tag of a conversation and process it asynchronously. If a tag with corresponding name does not exist it will be created. ## List tags - [GET /beta/conversations/{conversationId}/tags](https://docs.dixa.io/openapi/dixa-api/beta/conversations/getconversationsconversationidtags.md): Get the tags for a particular conversation by providing the conversation id. ## List messages - [GET /beta/conversations/{conversationId}/messages](https://docs.dixa.io/openapi/dixa-api/beta/conversations/getconversationsconversationidmessages.md): 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. ## Add message - [POST /beta/conversations/{conversationId}/messages](https://docs.dixa.io/openapi/dixa-api/beta/conversations/postconversationsconversationidmessages.md): 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. If attachments are added to the message, they will be copied and stored in Dixa. Supported channels are Chat, Messenger, Contact Form, Email, Sms (outbound only), Whatsapp (outbound and Markdown only). Supported Markdown syntax for Markdown content: bold \\text\\, italic \text\, bold & italic \\\text\\\, strikethrough \~text\~, blockquote \> Quoted text. \n Message about quoted text, ordered list List:\n1. Item\n2. Item\n3. Item, unordered list List:\n\ Item\n\ Item\n\* Item, inline code This is \code\. Whatsapp channel: Only one attachment is allowed per WhatsApp message. Supports the following file types for attachments: .jpg, .jpeg, .png, .pdf, .doc, .docx, .pptx, .xlsx ## Create conversation - [POST /beta/conversations](https://docs.dixa.io/openapi/dixa-api/beta/conversations/postconversations.md): 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. ## Import conversation - [POST /beta/conversations/import](https://docs.dixa.io/openapi/dixa-api/beta/conversations/postconversationsimport.md): Import a previously created conversation into Dixa. For inbound messages the author is assumed to be the requester of the conversation (end user), unless the specific channel supports overriding the message author through its attributes. For outbound messages the author is specified using the agentId field. ## Patch conversation custom attributes - [PATCH /beta/conversations/{conversationId}/custom-attributes](https://docs.dixa.io/openapi/dixa-api/beta/conversations/patchconversationsconversationidcustom-attributes.md): Patch custom attributes of a conversation ## Claim conversation - [PUT /beta/conversations/{conversationId}/claim](https://docs.dixa.io/openapi/dixa-api/beta/conversations/putconversationsconversationidclaim.md): Claim a conversation for a given agent. To avoid taking over assigned conversations, set the force paremeter to false ## List activity log - [GET /beta/conversations/{conversationId}/activitylog](https://docs.dixa.io/openapi/dixa-api/beta/conversations/getconversationsconversationidactivitylog.md): Get the activity log for a conversation by providing the conversation id. ## Get conversation - [GET /beta/conversations/{conversationId}](https://docs.dixa.io/openapi/dixa-api/beta/conversations/getconversationsconversationid.md): Get a conversation by id. ## Link a conversation to a parent conversation - [PUT /beta/conversations/{conversationId}/link](https://docs.dixa.io/openapi/dixa-api/beta/conversations/putconversationsconversationidlink.md): Links the specified conversation to a parent conversation with the specified link type. Limitations: * Maximum of 100 child conversations per parent * Only 1 parent per child conversation * A child conversation cannot have its own child conversations ## List linked conversations - [GET /beta/conversations/{conversationId}/linked](https://docs.dixa.io/openapi/dixa-api/beta/conversations/getconversationsconversationidlinked.md): Lists all linked child conversations for the given conversation ID, such as transcripts and side conversations. ## Search conversations with filters - [POST /beta/search/conversations](https://docs.dixa.io/openapi/dixa-api/beta/conversations/postsearchconversations.md): Search for conversations containing a particular text or by filter or combine them both ## List rating (deprecated) - [GET /beta/conversations/{conversationId}/rating](https://docs.dixa.io/openapi/dixa-api/beta/conversations/getconversationsconversationidrating.md): Deprecated rating endpoint. Use '/ratings'. ## Search conversations (deprecated) - [GET /beta/search/conversations](https://docs.dixa.io/openapi/dixa-api/beta/conversations/getsearchconversations.md): NOTE: This endpoint is deprecated and is replaced with POST /search/conversations. Search for conversations containing a particular text. ## Anonymize message - [PATCH /beta/conversations/{conversationId}/messages/{messageId}/anonymize](https://docs.dixa.io/openapi/dixa-api/beta/messages/patchconversationsconversationidmessagesmessageidanonymize.md): Request the anonymization of a single message in a conversation. ## List messages - [GET /beta/conversations/{conversationId}/messages](https://docs.dixa.io/openapi/dixa-api/beta/messages/getconversationsconversationidmessages.md): 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. ## Add message - [POST /beta/conversations/{conversationId}/messages](https://docs.dixa.io/openapi/dixa-api/beta/messages/postconversationsconversationidmessages.md): 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. If attachments are added to the message, they will be copied and stored in Dixa. Supported channels are Chat, Messenger, Contact Form, Email, Sms (outbound only), Whatsapp (outbound and Markdown only). Supported Markdown syntax for Markdown content: bold \\text\\, italic \text\, bold & italic \\\text\\\, strikethrough \~text\~, blockquote \> Quoted text. \n Message about quoted text, ordered list List:\n1. Item\n2. Item\n3. Item, unordered list List:\n\ Item\n\ Item\n\* Item, inline code This is \code\. Whatsapp channel: Only one attachment is allowed per WhatsApp message. Supports the following file types for attachments: .jpg, .jpeg, .png, .pdf, .doc, .docx, .pptx, .xlsx ## Add internal notes - [POST /beta/conversations/{conversationId}/notes/bulk](https://docs.dixa.io/openapi/dixa-api/beta/internal-notes/postconversationsconversationidnotesbulk.md): Create internal notes in a conversation by providing the conversation id. ## List internal notes - [GET /beta/conversations/{conversationId}/notes](https://docs.dixa.io/openapi/dixa-api/beta/internal-notes/getconversationsconversationidnotes.md): Get all internal notes for a particular conversation by providing the conversation id. ## Add internal note - [POST /beta/conversations/{conversationId}/notes](https://docs.dixa.io/openapi/dixa-api/beta/internal-notes/postconversationsconversationidnotes.md): Create an internal note in a conversation by providing the conversation id. ## Create conversation rating result - [POST /beta/conversations/{conversationId}/ratings/{ratingId}/submit](https://docs.dixa.io/openapi/dixa-api/beta/ratings/postconversationsconversationidratingsratingidsubmit.md): Create a rating result for a specific conversation. ## Create conversation rating offer - [POST /beta/conversations/{conversationId}/ratings/offer](https://docs.dixa.io/openapi/dixa-api/beta/ratings/postconversationsconversationidratingsoffer.md): Create a rating offer for a specific conversation. ## List ratings for a conversation - [GET /beta/conversations/{conversationId}/ratings](https://docs.dixa.io/openapi/dixa-api/beta/ratings/getconversationsconversationidratings.md): Lists latest ratings statuses for a particular conversation by providing the conversation ID. For surveys with multiple questions, rating status will be reported for each individual question of the survey. For example, a response for a 3 question survey that was answered will be 3 elements with status "Rated". Additionally, a multiple question survey can be partially answered, therefore a response of such case will be a mix of "Offered" and "Rated" statuses. Note that the IDs of multiple questions response elements will be the same, because they are part of the same survey. ## List rating (deprecated) - [GET /beta/conversations/{conversationId}/rating](https://docs.dixa.io/openapi/dixa-api/beta/ratings/getconversationsconversationidrating.md): Deprecated rating endpoint. Use '/ratings'. ## Tag conversation - [PUT /beta/conversations/{conversationId}/tags/{tagId}](https://docs.dixa.io/openapi/dixa-api/beta/tags/putconversationsconversationidtagstagid.md): Tag a conversation. You may only use active tags to tag conversations. ## Untag conversation - [DELETE /beta/conversations/{conversationId}/tags/{tagId}](https://docs.dixa.io/openapi/dixa-api/beta/tags/deleteconversationsconversationidtagstagid.md): Untag a conversation. You may remove active or inactive tags from a conversation. ## Bulk tag conversation - [POST /beta/conversations/{conversationId}/tags/bulk](https://docs.dixa.io/openapi/dixa-api/beta/tags/postconversationsconversationidtagsbulk.md): Initiate bulk tag of a conversation and process it asynchronously. If a tag with corresponding name does not exist it will be created. ## List tags - [GET /beta/conversations/{conversationId}/tags](https://docs.dixa.io/openapi/dixa-api/beta/tags/getconversationsconversationidtags.md): Get the tags for a particular conversation by providing the conversation id. ## Search conversations with filters - [POST /beta/search/conversations](https://docs.dixa.io/openapi/dixa-api/beta/search/postsearchconversations.md): Search for conversations containing a particular text or by filter or combine them both ## Search conversations (deprecated) - [GET /beta/search/conversations](https://docs.dixa.io/openapi/dixa-api/beta/search/getsearchconversations.md): NOTE: This endpoint is deprecated and is replaced with POST /search/conversations. Search for conversations containing a particular text.