Sessions

Add a message to a session

Changed on

Adds a user message and optionally waits for agent completion. Supports text, images, and file attachments. This feature is enabled for selected organizations only.

post/api/v0/sessions/{sessionId}/messages

Request

  • Base URL: https://api.factory.ai
  • URL: https://api.factory.ai/api/v0/sessions/{sessionId}/messages
  • Auth: HTTP bearer

Path parameters

sessionIdstring required

Request body

textstring required

Message text content

computerIdstring

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

Response

Response for status 200

messageIdstring required

ID of the created user message

status'idle' | 'pending' | 'running' required

Agent status after message submission

recipientDroidStatus'idle' | 'pending' | 'running'

The recipient's agent status before this message was submitted: idle means the message starts a turn now, running means it is queued behind the current turn. Omitted when the session was addressed by computerId.

Changes