Skip to main content
POST
Post a Studio message

Authorizations

Authorization
string
header
required

Bearer JWT token or API Key (sk-*).

Path Parameters

sessionId
string
required

Body

application/json
operationId
string<uuid>
required

Caller-generated UUID idempotency key for this exact operation.

studioActorId
string<uuid>

Optional expected actor identity. The host derives the actual actor from verified execution ancestry.

text
string

Message body. Maximum 10kB.

Maximum string length: 10000
Example:

"The nightly sync has completed successfully."

replyToMessageId
string

Message id this message replies to. Must belong to the same thread.

Example:

"00000000-0000-4000-8000-000000000001"

attachments
object[]

Attachment descriptors included with the message. Use STORAGE_UPLOAD with storageUploadSessionId for direct uploads that may still be finalizing.

Example:
chatUploadBatchId
string

Upload batch id whose finalized files are bound to this message.

Example:

"00000000-0000-4000-8000-000000000003"

Response

201