Create message in public chat

Creates a new message in an existing public chat. The chat must be the release's main topic chat or one of its asset public chats. **Authentication is optional.** A signed-in user posts with their real identity (`authorId`). An unauthenticated visitor may post anonymously by supplying a display name (`guestName`) — but only when the release has `allowAnonymousComments` enabled. The client should also send a stable `guestId` (a UUID it persists in localStorage per token) so two guests who type the same name stay distinct, plus an optional `guestColor`. Guest fields are ignored when the caller is authenticated. Attachments, mentions, asset mentions and quotes are not supported in public chats and are rejected with 400.

Creates a new message in an existing public chat. The chat must be the release's main topic chat or one of its asset public chats.

Authentication is optional. A signed-in user posts with their real identity (authorId). An unauthenticated visitor may post anonymously by supplying a display name (guestName) — but only when the release has allowAnonymousComments enabled. The client should also send a stable guestId (a UUID it persists in localStorage per token) so two guests who type the same name stay distinct, plus an optional guestColor. Guest fields are ignored when the caller is authenticated. Attachments, mentions, asset mentions and quotes are not supported in public chats and are rejected with 400.

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

token*string

The 10-character access token for the public file system.

Match^[a-zA-Z0-9]{10}$

Length10 <= length <= 10

chatId*string

The ID of the chat to get messages from or post to.

Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

content*string

The message content (HTML-sanitized server-side)

Length1 <= length <= 10000

replyToId?string

ID of the message being replied to

Formatuuid

annotations?array<|||||>

Array of annotations for images/videos

Itemsitems <= 100

guestId?string

Client-generated identity for an anonymous commenter, persisted in the visitor's localStorage per token. Keeps two same-named guests distinct. Ignored when authenticated.

Formatuuid

guestName?string

Display name for an anonymous commenter (HTML-sanitized). Required (and only used) when posting without authentication on an opted-in release.

Length1 <= length <= 40

guestColor?string

Color the anonymous commenter selected — the visible differentiator between guests. Must be one of the platform's approved colors (colors.approvedColors from GET /config). Ignored when authenticated.

Value in

"#37474F"
"#FF5722"
"#2962FF"
"#33691E"
"#00796B"
"#455A64"
"#2979FF"
"#827717"
"#7986CB"
"#8E24AA"
"#9575CD"
"#BF360C"
"#01579B"
"#EF6C00"
"#AA00FF"
"#F44336"
"#7C4DFF"
"#E65100"
"#8D6E63"
"#283593"
"#607D8B"
"#009688"
"#FF5252"
"#03A9F4"
"#C2185B"
"#00ACC1"
"#E91E63"
"#5D4037"
"#78909C"
"#1E88E5"
"#D500F9"
"#7E57C2"
"#5C6BC0"
"#558B2F"
"#2E7D32"
"#F50057"
"#004D40"
"#0D47A1"
"#C51162"
"#D50000"
"#6200EA"
"#00BCD4"
"#0277BD"

Response Body

`application/json`

curl -X POST "https://example.com/public/abc123xyz0/chat/497f6eca-6276-4993-bfeb-53cbbbba6f08/messages" \  -H "Content-Type: application/json" \  -d '{    "content": "string"  }'

{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "type": "user",  "dataType": "notification",  "dataId": "5647597e-5960-4cd9-8287-791d36aa4685",  "data": "808ac6e4-93ed-4040-85a5-6c71a2444e90",  "chatId": "f255124e-3419-4f6e-b7ee-17a6577db94d",  "chatType": "topic",  "authorId": "ee6f7132-bd0a-4fcd-83b3-a8022377067b",  "author": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "firstName": "string",    "lastName": "string",    "displayName": "string",    "avatar": "01d8bd6c-6014-46aa-b5b1-14d337c9c779",    "color": "string",    "awards": [      "staff"    ],    "accountType": "standard"  },  "guestId": "db7efe8f-f9c5-48b1-ba1e-30c39617b97d",  "guestName": "string",  "guestColor": "string",  "replyToId": null,  "content": "string",  "mentions": [    "777c52f7-3433-49cb-b0a3-cd6473c2c951"  ],  "assetMentions": [    "33c9f99d-d0e6-413a-8a20-2b070ddbb3e6"  ],  "folderMentions": [    "16b8140a-38c5-4330-83d5-bd6117a3e481"  ],  "submissionMentions": [    "dfb873dd-628b-446d-a7b3-aef774c3c50a"  ],  "publicMentions": [    "string"  ],  "taskMentions": [    "bb41b8dc-c355-4766-acc1-55693c83896e"  ],  "taskCards": [    "e3196039-692a-4ea1-be8d-6850035a72f9"  ],  "suggestedTasks": [    {      "subject": "string",      "description": "string",      "assignedToId": "7a15e53b-1403-4928-9451-d7062c3a8737",      "boardId": "a654038e-9287-48a2-acfd-90b8cfa8b1f4",      "columnId": "b0676e1a-d8a0-4c5f-99e7-a0ee8909f6dd"    }  ],  "quotes": [    "ea3b6941-45f7-4e0a-8d2b-6582d4d35a68"  ],  "attachments": [    "9904dd49-22c6-4edb-be09-aa27b9abd8f3"  ],  "revisions": [    {}  ],  "meta": {},  "status": "active",  "totalReplies": 0,  "recentReplies": [    "45984f84-2e0e-475b-b8a5-e4cfa03139f5"  ],  "annotations": [    {      "color": "#9b9b9b",      "frame": 0,      "timestamp": 0,      "startTimestamp": 0,      "endTimestamp": 0,      "left": 0,      "top": 0,      "width": 0.1,      "height": 0.1,      "scaleX": 1,      "scaleY": 1,      "angle": 0,      "skewX": 0,      "skewY": 0,      "flipX": false,      "flipY": false,      "originX": "left",      "originY": "top",      "opacity": 1,      "visible": true,      "shadow": {        "color": "rgba(0,0,0,0.3)",        "blur": 5,        "offsetX": 0.2,        "offsetY": 0.2      },      "strokeLineCap": "butt",      "strokeLineJoin": "miter",      "strokeMiterLimit": 4,      "strokeDashArray": [        0.1      ],      "fillRule": "nonzero",      "nestedAnnotations": [        {          "type": "dot",          "coordinates": {            "x": 0,            "y": 0          },          "radius": 10        }      ],      "type": "dot",      "coordinates": {        "x": 0,        "y": 0      },      "radius": 10    }  ],  "linkPreviews": [    {      "url": "http://example.com",      "title": "string",      "description": "string",      "image": "http://example.com",      "siteName": "string",      "favicon": "http://example.com",      "signature": "string"    }  ],  "reactions": [    {      "user": "76f62a58-5404-486d-9afc-07bded328704",      "emoji": "👍"    }  ],  "highlighted": false,  "highlightedById": "2ed80d19-af19-4b14-bdad-240edd29da18",  "isConvoMessage": false,  "scopeId": "65fafe40-a220-4dd7-8724-4598b81c0643",  "scopeType": "project",  "scopeVisibility": [    "creator"  ],  "inheritanceId": "09c886ac-e6e5-4263-a494-a6e14f7e4f46",  "aiRole": "assistant",  "aiModel": "string",  "aiTokensIn": 0,  "aiTokensOut": 0,  "aiToolCalls": [    {}  ],  "aiToolResults": [    {}  ],  "aiUsageEventId": "f5c2aaa2-8335-4359-b76a-d9a02c9cdabb",  "createdAt": 1678886400000,  "updatedAt": 1678886400000}

Authorization

Path Parameters

Request Body

Response Body

200application/json

400

403

404

`application/json`