Texa DeskDevelopers

Client API · Conversations

Resolve a conversation

POST/public/api/v1/inboxes/{inbox_identifier}/contacts/{contact_identifier}/conversations/{conversation_id}/toggle_status

Marks a conversation as resolved

Path parameters

inbox_identifierstringrequired

The identifier obtained from API inbox channel

contact_identifierstringrequired

The source id of contact obtained on contact create

conversation_idintegerrequired

The numeric ID of the conversation

Responses

200

Conversation resolved successfully

idinteger

Id of the conversation

uuidstring

UUID of the conversation

inbox_idinteger

The inbox id of the conversation

contact_last_seen_atinteger

Timestamp of when the contact last seen the conversation (Unix timestamp)

statusstring

The status of the conversation One of: open, resolved, pending, snoozed.

agent_last_seen_atinteger

Timestamp of when the agent last seen the conversation (Unix timestamp)

messagesarray of object

Messages in the conversation

messages[].idinteger

Id of the message

messages[].contentstring

Text content of the message. Can be null for attachment-only messages.

messages[].message_typeinteger

Denotes the message type. Possible values: 0 (incoming), 1 (outgoing), 2 (activity), 3 (template)

messages[].content_typestring

Content type of the message

messages[].content_attributesobject

Additional content attributes of the message

messages[].created_atinteger

Created at Unix timestamp of the message

messages[].conversation_idinteger

Display Id of the conversation the message belongs to

messages[].attachmentsarray of object

Attachments if any

messages[].attachments[].idinteger

Id of the attachment

messages[].attachments[].message_idinteger

Id of the parent message

messages[].attachments[].file_typestring

Type of the attached file One of: image, audio, video, file, location, fallback, share, story_mention, contact, ig_reel, ig_post, ig_story, embed.

messages[].attachments[].account_idinteger

Id of the account

messages[].attachments[].extensionstring

File extension

messages[].attachments[].data_urlstring

URL of the file. Can be null when an attachment variant has no external URL.

messages[].attachments[].thumb_urlstring

URL of the file thumbnail

messages[].attachments[].file_sizeinteger

File size in bytes

messages[].attachments[].widthinteger

Width of the attachment when available

messages[].attachments[].heightinteger

Height of the attachment when available

messages[].attachments[].coordinates_latnumber

Latitude for location attachments

messages[].attachments[].coordinates_longnumber

Longitude for location attachments

messages[].attachments[].fallback_titlestring

Fallback title for location, fallback, and contact attachments when available

messages[].attachments[].metaobject

Metadata for contact attachments

messages[].attachments[].transcribed_textstring

Transcribed text for audio attachments

messages[].senderobject

Polymorphic sender payload returned by push_event_data. Available fields vary by sender type.

messages[].sender.idinteger

Id of the sender

messages[].sender.namestring

Name of the sender when available

messages[].sender.thumbnailstring

Avatar/thumbnail URL of the sender. Contact senders use this field; user senders may also include it.

messages[].sender.typestring

Type of the sender One of: contact, user, agent_bot.

messages[].sender.available_namestring

Display name for user senders

messages[].sender.availability_statusstring

Availability status for user senders

messages[].sender.emailstring

Email of the sender when the sender is a contact

messages[].sender.phone_numberstring

Phone number of the sender when the sender is a contact

messages[].sender.identifierstring

Identifier of the sender when the sender is a contact

messages[].sender.blockedboolean

Whether the sender is blocked when the sender is a contact

messages[].sender.additional_attributesobject

Additional attributes when the sender is a contact and available

messages[].sender.custom_attributesobject

Custom attributes when the sender is a contact and available

contactobject

Full serialized contact record returned when the public API renders a Contact model directly.

contact.idinteger

Id of the contact

contact.namestring

Name of the contact when available

contact.emailstring

Email of the contact

contact.phone_numberstring

Phone number of the contact

contact.identifierstring

Identifier of the contact

contact.blockedboolean

Whether the contact is blocked

contact.additional_attributesobject

Additional attributes of the contact when present

contact.custom_attributesobject

Custom attributes of the contact when present

contact.contact_typestring

Contact type of the contact when available

contact.country_codestring

Country code of the contact

contact.last_activity_atstring

Last activity timestamp of the contact in ISO 8601 format

contact.created_atstring

Created timestamp of the contact in ISO 8601 format

contact.updated_atstring

Updated timestamp of the contact in ISO 8601 format

contact.last_namestring

Last name of the contact

contact.middle_namestring

Middle name of the contact

contact.locationstring

Location of the contact

contact.account_idinteger

Account id of the contact

contact.company_idinteger

Company id of the contact

contact.label_listarray of string

Labels applied to the contact

401

Unauthorized

descriptionstring
errorsarray of object
errors[].fieldstring
errors[].messagestring
errors[].codestring
404

Conversation not found

descriptionstring
errorsarray of object
errors[].fieldstring
errors[].messagestring
errors[].codestring