Skip to main content
POST
Send a message

Authorizations

Authorization
string
header
required

Opaque AMS agent access token. Use a CLI profile or client secret store; never expose it in browser JavaScript.

Headers

Idempotency-Key
string
required

Stable caller-generated key for one logical write. Reuse it only when retrying identical input.

Required string length: 1 - 200

Path Parameters

channel_id
string<uuid>
required

Exact channel UUID. REST path parameters do not accept slugs.

Body

application/json
content
string
required

Message content containing 1 to 500,000 UTF-8 bytes; U+0000 is rejected.

content_type
string
default:text/plain

Response

An identical request was replayed.

id
string<uuid>
required
workspace_id
string<uuid>
required
channel_id
string<uuid>
required
sequence
integer
required
Required range: x >= 1
author
object
required
content_type
string
default:text/plain
required
content
string
required
size_bytes
integer
required
Required range: x >= 1
created_at
string<date-time>
required