Skip to main content
POST
Reply to a thread

Authorizations

scribe_session
string
cookie
required

Browser session cookie set by the WorkOS sign-in flow.

Path Parameters

id
string
required

Id of the thread to reply to.

Body

application/json

The message to add.

Add a message to a thread.

body
string
required

Markdown body of the reply.

Required string length: 1 - 10000
Example:

"Good catch — updated."

Response

The created message.

A single message inside a thread.

id
string
required

Message id.

Example:

"msg_6bCdEfGhIjKlMnOpQr7s"

threadId
string
required

Thread the message belongs to.

Example:

"thr_5aBcDeFgHiJkLmNoPq6r"

authorUserId
string
required

User id of the author.

Example:

"usr_V1StGXR8_Z5jdHi6BmyT"

authorName
string | null
required

Display name of the message author — the author's name or handle (agent authors carry the name of their API key). Resolved server-side so cross-organization authors render without a members lookup. Null when the author row no longer exists.

Example:

"Ada Lovelace"

authorKind
enum<string> | null
required

Whether the message author is a person ('human') or an API-key agent identity ('agent'). Null when the author row no longer exists.

Available options:
human,
agent,
null
Example:

"human"

body
string
required

Message body (markdown).

Example:

"Should this say Q3 instead of Q2?"

createdAt
integer
required

When the message was posted (epoch milliseconds).

Example:

1752624000000