Update Conversation
curl --request PATCH \
  --url https://integration.getmateo.com/api/v1/conversation \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "inbox_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "assignee_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "open"
}'
{
  "id": "random uuid",
  "created_at": "now()",
  "updated_at": "now()",
  "organisation_id": "random uuid",
  "subject": "<string>",
  "status": "open",
  "assignee_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "unread": true,
  "channel_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "channel_type": "email",
  "contact_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "external_id": "<string>",
  "tags": {},
  "is_spam": false,
  "inbox_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "latest_message_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "latest_inbound_message_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "latest_message_created_at": "<string>",
  "latest_inbound_message_created_at": "<string>"
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

select
string

Select columns to return

id
string
required

Conversation ID

created_at
string

Conversation creation date

updated_at
string

Latest update

organisation_id
string

Organisation ID

subject
string

Subject of conversation

status
string

Status of conversation

assignee_id
string

Assignee ID

unread
string

Is conversation on unread?

channel_id
string

Channel ID

channel_type
string

Channel Type of Conversation

contact_id
string

Contact ID

external_id
string

External ID

tags
string

Given tags of conversation

is_spam
string

Is conversation marked as spam?

inbox_id
string

Inbox ID

latest_message_id
string

Latest message ID

latest_inbound_message_id
string

Latest inbound message ID

latest_message_created_at
string

Latest message creation date

latest_inbound_message_created_at
string

Latest inbound message creation date

Body

application/json

conversation

inbox_id
string<uuid>

Inbox ID

assignee_id
string<uuid> | null

Assignee ID

status
enum<string>
default:open

Status of conversation

Available options:
open,
closed,
archived

Response

The updated Conversation object

id
string<uuid>
default:random uuid

Conversation ID

created_at
string<timestamp with time zone>
default:now()

Conversation creation date

updated_at
string<timestamp with time zone>
default:now()

Latest update

organisation_id
string<uuid>
default:random uuid

Organisation ID

subject
string<text> | null

Subject of conversation

status
enum<string>
default:open

Status of conversation

Available options:
open,
closed,
archived
assignee_id
string<uuid> | null

Assignee ID

unread
boolean | null

Is conversation on unread?

channel_id
string<uuid>

Channel ID

channel_type
enum<string>

Channel Type of Conversation

Available options:
email,
sms,
whatsapp,
instagram,
facebook,
google_business_messaging,
postal
contact_id
string<uuid> | null

Contact ID

external_id
string<text> | null

External ID

tags
object | null

Given tags of conversation

is_spam
boolean
default:false

Is conversation marked as spam?

inbox_id
string<uuid>

Inbox ID

latest_message_id
string<uuid> | null

Latest message ID

latest_inbound_message_id
string<uuid> | null

Latest inbound message ID

latest_message_created_at
string<timestamp with time zone> | null

Latest message creation date

latest_inbound_message_created_at
string<timestamp with time zone> | null

Latest inbound message creation date