Skip to main content
POST
Add a message to a session

Authorizations

Authorization
string
header
required

Factory API key or JWT token for authentication

Path Parameters

sessionId
string
required

Body

application/json
text
string
required

Message text content

images
object[]

Optional base64-encoded images

files
object[]

Optional file attachments (PDFs, text files)

computerId
string

Computer ID to route the message to; falls back to the session.computerId if omitted

Response

Response for status 200

messageId
string
required

ID of the created user message

status
enum<string>
required

Agent status after message submission

Available options:
idle,
pending,
running