Create message on the main public chat (lazy creation)

Creates a message on the public file system's main topic chat. If the main chat does not exist yet it is created automatically (lazy creation pattern), using the release title as its subject. **Authentication is optional.** A signed-in user posts with their real identity (`authorId`); an unauthenticated visitor may post anonymously by supplying `guestName` when the release has `allowAnonymousComments` enabled. See the `guestId` / `guestColor` notes on `POST /public/{token}/chat/{chatId}/messages`. Attachments, mentions, asset mentions and quotes are not supported in public chats and are rejected with 400.

Creates a message on the public file system's main topic chat. If the main chat does not exist yet it is created automatically (lazy creation pattern), using the release title as its subject.

Authentication is optional. A signed-in user posts with their real identity (authorId); an unauthenticated visitor may post anonymously by supplying guestName when the release has allowAnonymousComments enabled. See the guestId / guestColor notes on POST /public/{token}/chat/{chatId}/messages. 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

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/messages" \  -H "Content-Type: application/json" \  -d '{    "content": "string"  }'

{  "chat": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "chatType": "topic",    "topicId": "97b608a9-302e-4387-a5f4-fd35969cdc21",    "topicType": "asset",    "replyType": "quote",    "subject": "string",    "visibility": "creator",    "publicId": "f72dfe8e-6cfd-43c2-b1cb-95adbf313789",    "participants": [      "e3139958-26f5-4fd4-a9c9-fe1c29c5cbac"    ],    "following": [      "6bc36f94-42f8-4778-8086-0f778a9e5f30"    ],    "annotations": [      {}    ],    "totalMessages": 0,    "lastMessageAt": "2019-08-24T14:15:22Z",    "recentMessages": [      "6738c803-41a8-4296-a5bd-8d9974ec6fa0"    ],    "activeConvoId": "6ac5e0e4-f5db-4276-ac1c-9dd077ad79d2",    "activeConvo": "d97b3779-3421-4076-bf6e-15252c014d1d",    "status": "active",    "createdAt": "2019-08-24T14:15:22Z",    "updatedAt": "2019-08-24T14:15:22Z"  },  "message": {    "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  }}