Send Message

Beta

POST/v1/messaging/conversations/{id}/messages

Idempotent with Idempotency-Key header. Learn more

Posts a message to a conversation.

With mode = send (the default) the message is delivered — immediately, or queued when scheduled_at is set — and the request is idempotent on client_message_id. With mode = draft a customer-reply draft is proposed on an external case: it is held at status draft for human approval rather than sent, and channel is required.

Permissions requiredValues:messaging:create

The role behind your API key or agent must grant every one of these permissions.

idstring

Conversation ID.

include[]optional arrayenumValues:senderauthorresource

Sub-objects to expand in the response. When omitted, sub-objects are returned as null.

bodystring

Message body.

Required unless the message carries at least one attachment or a resource link.

modeoptional stringenumValues:senddraft

Whether to deliver the message now or hold it as a customer-reply draft. Defaults to send.

send: delivers the message (immediately, or at scheduled_at). This is the default.
draft: proposes a customer-reply draft on an external case, held for human approval rather than sent. Requires channel.

channeloptional stringenumValues:messageemail

The channel a draft will be sent over when approved (mode = draft).

message: delivered as an in-conversation chat message.
email: delivered as an outbound email from the conversation's bridged inbox.

source_thread_message_idoptional string

The internal thread message a draft is composed from, when drafting from a thread (mode = draft).

client_message_idstring

Client-supplied dedupe key.

A resend with the same value returns the original message. Required when sending (mode = send); ignored for drafts.

audienceoptional stringenumValues:internalcustomer

Who the message is addressed to on an external case. Defaults to internal.

customer: sends a customer-visible reply, branded "Customer Service" and delivered by email on an email-bridged case.
internal: posts a team-only note that the customer never sees.

When omitted, the message is posted as an internal team-only note.

subjectoptional string

The email subject for a customer reply on an email-bridged case (audience = customer).

ccoptional array of string

Additional email recipients to copy on a customer reply (email channel).

scheduled_atoptional string (date-time)

When set, queue the message for delivery at this future time instead of sending now.

The created message has status scheduled.

reply_to_message_idoptional string

The message this one is a reply to.

link_resource_typeoptional stringenumValues:accountactorentity

Type of a resource to link in the message, paired with link_resource_id.

link_resource_idoptional string

ID of a resource to link in the message, paired with link_resource_type.

attachmentsoptional array of object

Attachments to include with the message.

kindstringenumValues:fileimagelink

The kind of attachment.

s3_keyoptional string

The object-storage key from the upload-url response (required for file/image).

filenameoptional string

The original filename (file/image).

content_typeoptional string

The MIME content type (file/image).

size_bytesoptional integer

The size in bytes (file/image).

urloptional string

The external URL (required for link).

resource_typeoptional string

The linked resource type (required for resource).

resource_idoptional string

The linked resource id (required for resource).

mentionsoptional array of string

Account user ids explicitly @mentioned in the message.

A mention delivers a notification even when the recipient has muted the conversation.

idstring

Message ID.

objectstringenumValues:chat_message

Resource type identifier.

kindstringenumValues:chatsystem_eventagent

The kind of message.

chat: a user-authored chat message.
system_event: a system-generated event message.
agent: a message authored by an AI agent participant.
scheduled: a message materialized from a scheduled send.
alert: a system or producer alert rendered as a message.
email: an inbound email materialized into the conversation by the email bridge.

statusstringenumValues:draftscheduledsent

The lifecycle state of the message.

draft: an editable customer-reply draft awaiting approval; not in the timeline.
scheduled: queued for delivery at a future time; not yet in the timeline.
sent: a delivered timeline message; only sent messages carry a sequence.
canceled: a scheduled message canceled before delivery.
rejected: a draft discarded without sending.
failed: a scheduled message that exhausted delivery attempts.
superseded: a draft replaced by a newer one for the same source thread.

visibilitystringenumValues:internalexternalsystem

Who can see this message.

internal: a team-only note.
external: sent to or received from an external party (e.g. the customer on a support case).
system: an event shown to both the team and the customer.

On a customer-facing conversation, customer payloads only ever carry external and system messages.

conversationconversationExpandablenullable

The conversation this message belongs to.

idstring

Conversation ID.

objectstringenumValues:conversation

Resource type identifier.

typestringenumValues:direct_messagegroupsystem

What kind of conversation this is.

direct_message: a 1:1 thread between two users.
group: a named thread with multiple user or agent members (including customer-facing support cases).
system: a system channel that delivers automated account alerts.

audiencestringenumValues:internalcustomer

Whether this is a team-only conversation (internal) or a customer-facing case (customer).

titlestringnullable

The display title of a group conversation.

null for direct messages, where the client derives a title from the participants.

workflow_statusstringnullableenumValues:newopenwaiting_internal

The triage lane of a customer-facing case.

Only set for customer-audience conversations.

new: opened but not yet triaged.
open: actively being worked.
waiting_internal: blocked on the internal team.
waiting_external: blocked on an external reply.
needs_approval: a drafted reply is awaiting human approval.
resolved: closed out.

groupmessaging_groupnullable

The reusable roster this conversation was started from, when one was used.

null for ad-hoc conversations. Provenance only: members were copied in at creation and are not driven by the roster thereafter.

Always returned as null in this endpoint.

statusstringenumValues:activearchivedhidden

The caller's effective status.

hidden when the caller has hidden the conversation
otherwise the account-level lifecycle state

legal_holdstringenumValues:releasedheld

Whether the conversation is under legal hold.

Exempts the conversation from retention purging and redaction.

assigneeactornullable

The case owner, when one is set: a user actor (a team member) or a group actor (a team).

Always returned as null in this endpoint.

participantslistExpandablenullable

The active participants of the conversation.

objectstringenumValues:list

Resource type identifier.

page_infoobject

Pagination metadata.

next_page_urlstringnullable

Relative URL that fetches the next page of results.

null when the last page has been reached.

previous_page_urlstringnullable

Relative URL that fetches the previous page of results.

null while on the first page.

has_next_pageboolean

Whether more results exist after this page.

has_prev_pageboolean

Whether results exist before this page.

dataarray of conversation_participant

Resources in this page.

idstring

Participant ID.

objectstringenumValues:conversation_participant

Resource type identifier.

typestringenumValues:useragentsystem

The kind of participant.

user: an account user (a teammate).
agent: an AI agent.
system: the system itself, which posts automated messages.
customer: an external customer in a support case.

rolestringenumValues:owneradminmember

The participant's permission level in the conversation.

owner: can rename or delete the conversation and manage its members and their roles.
admin: can add or remove members and rename the conversation.
member: can post, react, mute, and leave.
viewer: read-only access.

membershipstringenumValues:activeleftremoved

The participant's membership in the conversation.

active: currently a member.
left: voluntarily left the conversation.
removed: removed by an admin.
hidden: still a member but has hidden the conversation from their own list.

notificationsstringenumValues:unmutedmuted

The participant's notification preference for the conversation.

unmuted: receives normal notifications.
muted: notifications are suppressed (mentions may still pierce the mute).

actoractornullable

The actor this participant represents: a user (account user) or an agent.

null for system participants.

Always returned as null in this endpoint.

agent_trigger_policystringnullableenumValues:mentionkeywordalways

For agent participants, when the agent is invoked in response to messages.

null for non-agent participants.

mention: only when the agent is @mentioned.
keyword: when a message contains one of the agent's trigger keywords.
always: on every human message in the conversation.

agent_trigger_keywordsarray of string

For agent participants with a keyword/mention policy, the keywords that trigger it.

topicentitynullable

The app resource this conversation is anchored to (e.g. an order).

null when the conversation has no topic anchor.

Always returned as null in this endpoint.

unreadinteger

Number of messages the caller has not yet read.

last_message_atstring (date-time)nullable

When the most recent message was sent.

null when the conversation has no messages yet.

last_messagechat_messageExpandablenullable

The most recent message in the conversation.

null when the conversation has no messages yet.

idstring

Message ID.

objectstringenumValues:chat_message

Resource type identifier.

kindstringenumValues:chatsystem_eventagent

The kind of message.

chat: a user-authored chat message.
system_event: a system-generated event message.
agent: a message authored by an AI agent participant.
scheduled: a message materialized from a scheduled send.
alert: a system or producer alert rendered as a message.
email: an inbound email materialized into the conversation by the email bridge.

statusstringenumValues:draftscheduledsent

The lifecycle state of the message.

draft: an editable customer-reply draft awaiting approval; not in the timeline.
scheduled: queued for delivery at a future time; not yet in the timeline.
sent: a delivered timeline message; only sent messages carry a sequence.
canceled: a scheduled message canceled before delivery.
rejected: a draft discarded without sending.
failed: a scheduled message that exhausted delivery attempts.
superseded: a draft replaced by a newer one for the same source thread.

visibilitystringenumValues:internalexternalsystem

Who can see this message.

internal: a team-only note.
external: sent to or received from an external party (e.g. the customer on a support case).
system: an event shown to both the team and the customer.

On a customer-facing conversation, customer payloads only ever carry external and system messages.

conversationconversationnullable

The conversation this message belongs to.

Always returned as null in this endpoint.

sequenceinteger

Monotonic per-conversation ordering sequence.

bodystringnullable

Message body.

null for templated or deleted messages.

subjectstringnullable

The email subject of a customer-reply draft on an email-bridged case.

senderactornullable

The actor that sent the message, as displayed. When the message was posted under a sender identity (a persona / group), this is that persona; otherwise it is the authoring user.

null for pure system messages.

Always returned as null in this endpoint.

authoractornullable

The underlying account user who authored the message.

null for system messages, or when the message was posted under an anonymizing sender identity and the caller is not entitled to see the real author.

Always returned as null in this endpoint.

attachmentslistnullable

Files, images, links, or resources attached to the message.

Always returned as null in this endpoint.

reply_tochat_messagenullable

The message this one replies to.

Always returned as null in this endpoint.

resourceentitynullable

The app resource this message links to.

Always returned as null in this endpoint.

channelstringenumValues:messageemail

How the message was delivered (or, for a draft, how it will be on approve).

message: delivered as an in-conversation chat message.
email: delivered as email through the conversation's bridged inbox.

scheduled_atstring (date-time)nullable

When a scheduled message is due to be delivered.

agent_runagent_runnullable

The agent run that produced this message, for deep-linking from an agent reply to its run.

null for messages not produced by an agent.

Always returned as null in this endpoint.

streaming_statestringnullable

The streaming state of a reply.

streaming while the body is still being generated (it fills in via realtime updates); complete once finalized.

null for ordinary messages.

client_message_idstringnullable

The client-supplied dedupe key echoed back for optimistic-UI reconciliation.

null for server-generated messages.

edited_atstring (date-time)nullable

When the message was last edited.

deleted_atstring (date-time)nullable

When the message was deleted (tombstone).

created_atstring (date-time)

Creation timestamp.

updated_atstring (date-time)

Last update timestamp.

created_atstring (date-time)

Creation timestamp.

updated_atstring (date-time)

Last update timestamp.

sequenceinteger

Monotonic per-conversation ordering sequence.

bodystringnullable

Message body.

null for templated or deleted messages.

subjectstringnullable

The email subject of a customer-reply draft on an email-bridged case.

senderactorExpandablenullable

The actor that sent the message, as displayed. When the message was posted under a sender identity (a persona / group), this is that persona; otherwise it is the authoring user.

null for pure system messages.

idstring

Unique identifier of the actor.

objectstringenumValues:actor

Resource type identifier.

typestringenumValues:userapi_keyagent

Actor type.

user: a human user account.
api_key: a programmatic caller authenticating with an API key.
agent: an automated agent acting on the account's behalf.
group: a shared group identity, such as a "Customer Service" persona, rather than a single individual.

namestringnullable

The actor's display name.

handlestringnullable

Human-readable handle identifying the actor.

For user actors: the user's email address.
For api_key actors: the redacted key value.

Other actor types carry no handle.

avatar_urlstringnullable

URL of the actor's profile photo, if one is set.

Only populated for user actors.

rolerolenullable

Assigned role.

Always returned as null in this endpoint.

authoractorExpandablenullable

The underlying account user who authored the message.

null for system messages, or when the message was posted under an anonymizing sender identity and the caller is not entitled to see the real author.

idstring

Unique identifier of the actor.

objectstringenumValues:actor

Resource type identifier.

typestringenumValues:userapi_keyagent

Actor type.

user: a human user account.
api_key: a programmatic caller authenticating with an API key.
agent: an automated agent acting on the account's behalf.
group: a shared group identity, such as a "Customer Service" persona, rather than a single individual.

namestringnullable

The actor's display name.

handlestringnullable

Human-readable handle identifying the actor.

For user actors: the user's email address.
For api_key actors: the redacted key value.

Other actor types carry no handle.

avatar_urlstringnullable

URL of the actor's profile photo, if one is set.

Only populated for user actors.

rolerolenullable

Assigned role.

Always returned as null in this endpoint.

attachmentslistExpandablenullable

Files, images, links, or resources attached to the message.

objectstringenumValues:list

Resource type identifier.

page_infoobject

Pagination metadata.

next_page_urlstringnullable

Relative URL that fetches the next page of results.

null when the last page has been reached.

previous_page_urlstringnullable

Relative URL that fetches the previous page of results.

null while on the first page.

has_next_pageboolean

Whether more results exist after this page.

has_prev_pageboolean

Whether results exist before this page.

dataarray of message_attachment

Resources in this page.

idstring

Attachment ID.

objectstringenumValues:message_attachment

Resource type identifier.

kindstringenumValues:fileimagelink

The kind of attachment, which determines how it is stored and which of the fields below are populated.

file: an uploaded non-image file.
image: an uploaded image.
link: an external URL reference, with no stored file.
resource: a reference to an in-app resource, such as an order.

filenamestringnullable

The original filename for uploaded attachments.

null for link/resource attachments.

content_typestringnullable

The MIME content type for uploaded attachments.

null for link/resource attachments.

size_bytesintegernullable

The size in bytes for uploaded attachments.

null when unknown or for link/resource attachments.

urlstringnullable

A time-limited download URL for uploaded (file/image) attachments, or the link URL.

null for resource attachments.

resourceentitynullable

The linked in-app resource for resource attachments.

null for file/image/link attachments.

Always returned as null in this endpoint.

created_atstring (date-time)

Creation timestamp.

reply_tochat_messageExpandablenullable

The message this one replies to.

idstring

Message ID.

objectstringenumValues:chat_message

Resource type identifier.

kindstringenumValues:chatsystem_eventagent

The kind of message.

chat: a user-authored chat message.
system_event: a system-generated event message.
agent: a message authored by an AI agent participant.
scheduled: a message materialized from a scheduled send.
alert: a system or producer alert rendered as a message.
email: an inbound email materialized into the conversation by the email bridge.

statusstringenumValues:draftscheduledsent

The lifecycle state of the message.

draft: an editable customer-reply draft awaiting approval; not in the timeline.
scheduled: queued for delivery at a future time; not yet in the timeline.
sent: a delivered timeline message; only sent messages carry a sequence.
canceled: a scheduled message canceled before delivery.
rejected: a draft discarded without sending.
failed: a scheduled message that exhausted delivery attempts.
superseded: a draft replaced by a newer one for the same source thread.

visibilitystringenumValues:internalexternalsystem

Who can see this message.

internal: a team-only note.
external: sent to or received from an external party (e.g. the customer on a support case).
system: an event shown to both the team and the customer.

On a customer-facing conversation, customer payloads only ever carry external and system messages.

conversationconversationExpandablenullable

The conversation this message belongs to.

Always returned as null in this endpoint.

sequenceinteger

Monotonic per-conversation ordering sequence.

bodystringnullable

Message body.

null for templated or deleted messages.

subjectstringnullable

The email subject of a customer-reply draft on an email-bridged case.

senderactorExpandablenullable

The actor that sent the message, as displayed. When the message was posted under a sender identity (a persona / group), this is that persona; otherwise it is the authoring user.

null for pure system messages.

idstring

Unique identifier of the actor.

objectstringenumValues:actor

Resource type identifier.

typestringenumValues:userapi_keyagent

Actor type.

user: a human user account.
api_key: a programmatic caller authenticating with an API key.
agent: an automated agent acting on the account's behalf.
group: a shared group identity, such as a "Customer Service" persona, rather than a single individual.

namestringnullable

The actor's display name.

handlestringnullable

Human-readable handle identifying the actor.

For user actors: the user's email address.
For api_key actors: the redacted key value.

Other actor types carry no handle.

avatar_urlstringnullable

URL of the actor's profile photo, if one is set.

Only populated for user actors.

rolerolenullable

Assigned role.

Always returned as null in this endpoint.

authoractorExpandablenullable

The underlying account user who authored the message.

null for system messages, or when the message was posted under an anonymizing sender identity and the caller is not entitled to see the real author.

idstring

Unique identifier of the actor.

objectstringenumValues:actor

Resource type identifier.

typestringenumValues:userapi_keyagent

Actor type.

user: a human user account.
api_key: a programmatic caller authenticating with an API key.
agent: an automated agent acting on the account's behalf.
group: a shared group identity, such as a "Customer Service" persona, rather than a single individual.

namestringnullable

The actor's display name.

handlestringnullable

Human-readable handle identifying the actor.

For user actors: the user's email address.
For api_key actors: the redacted key value.

Other actor types carry no handle.

avatar_urlstringnullable

URL of the actor's profile photo, if one is set.

Only populated for user actors.

rolerolenullable

Assigned role.

Always returned as null in this endpoint.

attachmentslistExpandablenullable

Files, images, links, or resources attached to the message.

objectstringenumValues:list

Resource type identifier.

page_infoobject

Pagination metadata.

next_page_urlstringnullable

Relative URL that fetches the next page of results.

null when the last page has been reached.

previous_page_urlstringnullable

Relative URL that fetches the previous page of results.

null while on the first page.

has_next_pageboolean

Whether more results exist after this page.

has_prev_pageboolean

Whether results exist before this page.

dataarray of message_attachment

Resources in this page.

idstring

Attachment ID.

objectstringenumValues:message_attachment

Resource type identifier.

kindstringenumValues:fileimagelink

The kind of attachment, which determines how it is stored and which of the fields below are populated.

file: an uploaded non-image file.
image: an uploaded image.
link: an external URL reference, with no stored file.
resource: a reference to an in-app resource, such as an order.

filenamestringnullable

The original filename for uploaded attachments.

null for link/resource attachments.

content_typestringnullable

The MIME content type for uploaded attachments.

null for link/resource attachments.

size_bytesintegernullable

The size in bytes for uploaded attachments.

null when unknown or for link/resource attachments.

urlstringnullable

A time-limited download URL for uploaded (file/image) attachments, or the link URL.

null for resource attachments.

resourceentitynullable

The linked in-app resource for resource attachments.

null for file/image/link attachments.

Always returned as null in this endpoint.

created_atstring (date-time)

Creation timestamp.

reply_tochat_messageExpandablenullable

The message this one replies to.

Always returned as null in this endpoint.

resourceentityExpandablenullable

The app resource this message links to.

Always returned as null in this endpoint.

channelstringenumValues:messageemail

How the message was delivered (or, for a draft, how it will be on approve).

message: delivered as an in-conversation chat message.
email: delivered as email through the conversation's bridged inbox.

scheduled_atstring (date-time)nullable

When a scheduled message is due to be delivered.

agent_runagent_runExpandablenullable

The agent run that produced this message, for deep-linking from an agent reply to its run.

null for messages not produced by an agent.

Always returned as null in this endpoint.

streaming_statestringnullable

The streaming state of a reply.

streaming while the body is still being generated (it fills in via realtime updates); complete once finalized.

null for ordinary messages.

client_message_idstringnullable

The client-supplied dedupe key echoed back for optimistic-UI reconciliation.

null for server-generated messages.

edited_atstring (date-time)nullable

When the message was last edited.

deleted_atstring (date-time)nullable

When the message was deleted (tombstone).

created_atstring (date-time)

Creation timestamp.

updated_atstring (date-time)

Last update timestamp.

resourceentityExpandablenullable

The app resource this message links to.

idstring

Unique identifier for the entity.

objectstringenumValues:entity

Resource type identifier.

typestringenumValues:accountactorentity

The resource kind that this entity references, as an object-type value (e.g. user, account).

Unlike object — which is always entity — this names the underlying resource the id points to.

namestringnullable

Human-readable display name for the entity (e.g. a user's full name, a sales order number).

handlestringnullable

Secondary human-readable identifier (e.g. email address, username, redacted API key value).

channelstringenumValues:messageemail

How the message was delivered (or, for a draft, how it will be on approve).

message: delivered as an in-conversation chat message.
email: delivered as email through the conversation's bridged inbox.

scheduled_atstring (date-time)nullable

When a scheduled message is due to be delivered.

agent_runagent_runExpandablenullable

The agent run that produced this message, for deep-linking from an agent reply to its run.

null for messages not produced by an agent.

idstring

Agent run ID.

objectstringenumValues:agent_run

Resource type identifier.

trigger_typestringenumValues:scheduledmanualevent

How this run was initiated.

scheduled: started by the agent's cron schedule.
event: started in response to a platform event.
manual: started by an explicit request; see triggered_by.
chat: started by a message in a conversation, with the agent's reply posted back into that conversation.

statusstringenumValues:pendingrunningcompleted

Current run status.

pending: queued but not yet started.
running: currently executing.
awaiting_input: paused, waiting for user input before continuing.
awaiting_approval: paused, waiting for a pending action to be approved.
completed: finished successfully.
failed: stopped after an error; see error_message.
cancelled: stopped before completion by a user.

definitionagent_definitionnullable

Full agent definition for this run.

Always returned as null in this endpoint.

inputobjectnullable

Input provided to the agent at the start of the run, as JSON.

Encoded as a JSON value (object, array, string, number, boolean, or null), not a JSON-encoded string.

outputobjectnullable

Final output produced by the agent, as JSON.

Populated only once the run has completed successfully.

Encoded as a JSON value (object, array, string, number, boolean, or null), not a JSON-encoded string.

error_messagestringnullable

Error message if the run failed.

triggered_byactornullable

Actor that triggered this run.

Null for scheduled or event-triggered runs.

Always returned as null in this endpoint.

started_atstring (date-time)nullable

When the run started executing.

completed_atstring (date-time)nullable

When the run completed.

duration_msintegernullable

Duration in milliseconds.

actionslistnullable

Actions performed during this run.

Always returned as null in this endpoint.

stepslistnullable

Timeline steps for this run.

Always returned as null in this endpoint.

created_atstring (date-time)

When this run was created.

updated_atstring (date-time)

When this run was last updated.

streaming_statestringnullable

The streaming state of a reply.

streaming while the body is still being generated (it fills in via realtime updates); complete once finalized.

null for ordinary messages.

client_message_idstringnullable

The client-supplied dedupe key echoed back for optimistic-UI reconciliation.

null for server-generated messages.

edited_atstring (date-time)nullable

When the message was last edited.

deleted_atstring (date-time)nullable

When the message was deleted (tombstone).

created_atstring (date-time)

Creation timestamp.

updated_atstring (date-time)

Last update timestamp.

Responses

201

Successful response for Send Message

Send Message

import Augno from '@augno/sdk';

const client = new Augno({
  bearerToken: 'YOUR_API_KEY', // Your API key goes here
});

const message = await client.messaging.conversations.messages.create(
  'cv_01h9z8q1w2e3r4t5y6u7i8cv',
  { body: 'Sounds good — shipping it today.', client_message_id: 'client_msg_8c7d2f' },
);

console.log(message.id);

import Augno from '@augno/sdk';

const client = new Augno({
  bearerToken: 'YOUR_API_KEY', // Your API key goes here
});

const message = await client.messaging.conversations.messages.create(
  'cv_01h9z8q1w2e3r4t5y6u7i8cv',
  { body: 'Sounds good — shipping it today.', client_message_id: 'client_msg_8c7d2f' },
);

console.log(message.id);

201 example

{
  "id": "mg_01h9z8q1w2e3r4t5y6u7i8mg",
  "object": "chat_message",
  "kind": "chat",
  "status": "sent",
  "visibility": "internal",
  "conversation": {
    "id": "cv_01h9z8q1w2e3r4t5y6u7i8cv",
    "object": "conversation",
    "type": "direct_message",
    "audience": "internal",
    "title": null,
    "workflow_status": null,
    "group": null,
    "status": "active",
    "legal_hold": "released",
    "assignee": null,
    "participants": {
      "object": "list",
      "page_info": {
        "next_page_url": null,
        "previous_page_url": null,
        "has_next_page": false,
        "has_prev_page": false
      },
      "data": [
        {
          "id": "cvpt_01h9z8q1w2e3r4t5y6u7cvpt",
          "object": "conversation_participant",
          "type": "user",
          "role": "member",
          "membership": "active",
          "notifications": "unmuted",
          "actor": null,
          "agent_trigger_policy": null,
          "agent_trigger_keywords": []
        }
      ]
    },
    "topic": null,
    "unread": 2,
    "last_message_at": "2026-05-10T00:23:00Z",
    "last_message": null,
    "created_at": "2026-05-10T00:00:00Z",
    "updated_at": "2026-05-10T00:23:00Z"
  },
  "sequence": 42,
  "body": "Sounds good — shipping it today.",
  "subject": null,
  "sender": {
    "id": "acus_01ea9983ddb41dacc44ecf997c",
    "object": "actor",
    "type": "user",
    "name": "Jie Yan",
    "handle": null,
    "avatar_url": null,
    "role": null
  },
  "author": {
    "id": "acus_01ea9983ddb41dacc44ecf997c",
    "object": "actor",
    "type": "user",
    "name": "Jie Yan",
    "handle": null,
    "avatar_url": null,
    "role": null
  },
  "attachments": {
    "object": "list",
    "page_info": {
      "next_page_url": null,
      "previous_page_url": null,
      "has_next_page": false,
      "has_prev_page": false
    },
    "data": [
      {
        "id": "mgah_01h9z8q1w2e3r4t5y6u7mgah",
        "object": "message_attachment",
        "kind": "image",
        "filename": "diagram.png",
        "content_type": "image/png",
        "size_bytes": 48213,
        "url": "https://chat-bucket.s3.amazonaws.com/chat/ac/cv/mgah/diagram.png?X-Amz-Signature=...",
        "resource": null,
        "created_at": "2026-05-10T00:00:00Z"
      }
    ]
  },
  "reply_to": null,
  "resource": null,
  "channel": "message",
  "scheduled_at": null,
  "agent_run": null,
  "streaming_state": null,
  "client_message_id": null,
  "edited_at": null,
  "deleted_at": null,
  "created_at": "2026-05-10T00:00:00Z",
  "updated_at": "2026-05-10T00:23:00Z"
}

{
  "id": "mg_01h9z8q1w2e3r4t5y6u7i8mg",
  "object": "chat_message",
  "kind": "chat",
  "status": "sent",
  "visibility": "internal",
  "conversation": {
    "id": "cv_01h9z8q1w2e3r4t5y6u7i8cv",
    "object": "conversation",
    "type": "direct_message",
    "audience": "internal",
    "title": null,
    "workflow_status": null,
    "group": null,
    "status": "active",
    "legal_hold": "released",
    "assignee": null,
    "participants": {
      "object": "list",
      "page_info": {
        "next_page_url": null,
        "previous_page_url": null,
        "has_next_page": false,
        "has_prev_page": false
      },
      "data": [
        {
          "id": "cvpt_01h9z8q1w2e3r4t5y6u7cvpt",
          "object": "conversation_participant",
          "type": "user",
          "role": "member",
          "membership": "active",
          "notifications": "unmuted",
          "actor": null,
          "agent_trigger_policy": null,
          "agent_trigger_keywords": []
        }
      ]
    },
    "topic": null,
    "unread": 2,
    "last_message_at": "2026-05-10T00:23:00Z",
    "last_message": null,
    "created_at": "2026-05-10T00:00:00Z",
    "updated_at": "2026-05-10T00:23:00Z"
  },
  "sequence": 42,
  "body": "Sounds good — shipping it today.",
  "subject": null,
  "sender": {
    "id": "acus_01ea9983ddb41dacc44ecf997c",
    "object": "actor",
    "type": "user",
    "name": "Jie Yan",
    "handle": null,
    "avatar_url": null,
    "role": null
  },
  "author": {
    "id": "acus_01ea9983ddb41dacc44ecf997c",
    "object": "actor",
    "type": "user",
    "name": "Jie Yan",
    "handle": null,
    "avatar_url": null,
    "role": null
  },
  "attachments": {
    "object": "list",
    "page_info": {
      "next_page_url": null,
      "previous_page_url": null,
      "has_next_page": false,
      "has_prev_page": false
    },
    "data": [
      {
        "id": "mgah_01h9z8q1w2e3r4t5y6u7mgah",
        "object": "message_attachment",
        "kind": "image",
        "filename": "diagram.png",
        "content_type": "image/png",
        "size_bytes": 48213,
        "url": "https://chat-bucket.s3.amazonaws.com/chat/ac/cv/mgah/diagram.png?X-Amz-Signature=...",
        "resource": null,
        "created_at": "2026-05-10T00:00:00Z"
      }
    ]
  },
  "reply_to": null,
  "resource": null,
  "channel": "message",
  "scheduled_at": null,
  "agent_run": null,
  "streaming_state": null,
  "client_message_id": null,
  "edited_at": null,
  "deleted_at": null,
  "created_at": "2026-05-10T00:00:00Z",
  "updated_at": "2026-05-10T00:23:00Z"
}

Send Message

Authorization

Path Parameters

Query Parameters

Request Body

Returns

Responses