Send a message

POST

/api/chat/channels/{channelId}/messages

• Production
• Local Development

Rate limited to 30 per minute per user per band. Attachment keys must have come from this channel’s upload-url endpoint. Mentions are pinged separately from the channel fan-out.

Authorizations

• bearerAuth

Parameters

Path Parameters

channelId

required

string format: uuid

Request Body

Message to send

object

content

string

"" <= 5000 characters

metadata

object

key

additional properties

nullable

attachments

Array<object>

<= 4 items

object

key

required

string

>= 1 characters <= 500 characters

name

required

string

>= 1 characters <= 255 characters

size

required

integer

contentType

required

string

>= 1 characters <= 120 characters

Responses

201

Sent

object

ok

required

boolean

data

nullable

400

Invalid input, or an attachment from another channel

object

ok

required

boolean

error

required

string

code

string

401

Unauthenticated

object

ok

required

boolean

error

required

string

code

string

403

Forbidden

object

ok

required

boolean

error

required

string

code

string

404

Channel not found

object

ok

required

boolean

error

required

string

code

string

429

Too many messages

object

ok

required

boolean

error

required

string

code

string

500

Server error

object

ok

required

boolean

error

required

string

code

string