Sign in

v1

latestOpenAPI 3.0.02026-07-26870415.2 KB
conversations

Send message to conversation

Sends a reply on the current conversation thread. Requires a token with write access and uses the active channel/thread behind the conversation.

post/v1/conversations/{id}/messages

Path parameters

idstring required

Canonical conversation id.

Example:ph77c0dy0mgdpzmqz6tesry8w184002s

Query parameters

workspace_idstring

Optional workspace override. If omitted, Conduit resolves the conversation's workspace automatically.

Example:j57demo8f8x7c9v0n2q4r6t8y1u3i5o

Request body

bodystring required

Example request

{
  "body": "Hi there, can you confirm check-in time?",
  "attachments": [
    {
      "attachment_id": "kg2a8d8w8zv1m9q9f9h7e3b2n97j6x2c",
      "name": "failed-contacts.csv",
      "content_type": "text/csv",
      "content_length": 18432
    }
  ]
}

Response

Conversation message sent

Example response

{
  "data": {
    "id": "yh7t5azsr0zpfpyf67vtce0j6n844y1e",
    "workspace_id": "j57demo8f8x7c9v0n2q4r6t8y1u3i5o",
    "conversation_id": "ph77c0dy0mgdpzmqz6tesry8w184002s",
    "ticket_id": null,
    "channel": "unthreaded_email",
    "status": "sent"
  }
}