Conversations

Create a message

Changed on Oct 21, 2026

Create a message in the workspace identified by {wId} in the conversation identified by {cId}.

post/api/v1/w/{wId}/assistant/conversations/{cId}/messages

Request

Base URL
https://dust.tt
Auth
HTTP bearer
TypeScript
https://skmtc.dev/dust-tt/apis/dust-api-documentation/docs/api/v1/w/:wId/assistant/conversations/:cId/messages/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

wIdstring required

ID of the workspace

cIdstring required

ID of the conversation

Request body

contentstring required

The content of the message. Should not be empty.

Example request

{
  "content": "This is my message",
  "mentions": [
    {
      "configurationId": "7f3a9c2b1e"
    }
  ],
  "context": {
    "username": "johndoe123",
    "timezone": "America/New_York",
    "fullName": "John Doe",
    "email": "john.doe@example.com",
    "profilePictureUrl": "https://example.com/profiles/johndoe123.jpg",
    "agenticMessageData": {
      "originMessageId": "2b8e4f6a0c"
    }
  },
  "modelSelection": {
    "providerId": "anthropic",
    "modelId": "claude-sonnet-4-20250514",
    "reasoningEffort": "medium"
  }
}

Response

Message created successfully.