Sign in

v1

latestOpenAPI 3.1.02026-07-22100167210.7 KB
Replica

Send Message

Sends a message to an existing replica. Supports targeting a specific chat, choosing a coding agent and model, attaching images, and enabling plan mode.

post/v1/replica/{id}/messages

Path parameters

idstring uuid required

The unique identifier of the replica

Request body

messagestring required

Message to send to the coding agent

coding_agent'claude' | 'codex' | 'cursor' | 'opencode' | 'pi'

Coding agent to use

chat_idstring

Target a specific chat session

modelstring

Model to use for this message. Pi and Opencode accept z-ai/glm-5.2, minimax/minimax-m3, xiaomi/mimo-v2.5-pro, and moonshotai/kimi-k2.6 through OpenRouter.

plan_modeboolean

Whether to run in plan mode. Leading /plan in the message is also detected and stripped.

goal_modeboolean

Whether to set the message as the active Codex goal. Leading /goal in the message is also detected and stripped.

fast_modeboolean

Whether to run in fast mode. Leading /fast in the message is also detected and stripped.

thinking_level'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'ultra' | 'ultracode'

Thinking/reasoning level. Controls how much effort the agent puts into reasoning. ultra is Codex-only; ultracode is Claude Code-only. Falls back to provider default when omitted (Claude default: high, Codex default: medium, Cursor default: medium, Opencode default: medium, Pi default: model default).

senderUserIdstring

Identifier of the user sending this message. When the request is authenticated via dashboard auth, the server overrides this with the authenticated user's id so team workspaces can attribute messages to the actual sender.

senderEmailstring

Email of the user sending this message. When the request is authenticated via dashboard auth, the server overrides this with the authenticated user's email.

Response

Message accepted

status'sent' | 'queued' | 'waking' required

Status of the message delivery

message_idstring nullable required

Unique identifier for the sent message

positioninteger nullable required

Queue position if status is 'queued'

chat_idstring nullable required

ID of the chat the message was sent to