AgentSessions

Send a message to a coding agent, streaming the reply (SSE)

Changed on
post/api/v0beta1/agent-sessions/stream

Request

  • Base URL
    https://app.amika.dev (the document declares no server; this is the origin it was published from)
  • URL
    https://app.amika.dev/api/v0beta1/agent-sessions/stream
  • Auth
    • HTTP bearer
    • or API key in cookie wos-session

Request body

messagestring required
agent'claude' | 'codex'
session_idstring
sandbox_idstring

Route into the sandbox with this id instead of a fresh one. Matches by id only; send sandbox_name or sandbox_ref to name the sandbox. At most one of sandbox_id, sandbox_name, sandbox_ref.

sandbox_namestring

Route into the sandbox with this name instead of a fresh one. At most one of sandbox_id, sandbox_name, sandbox_ref.

sandbox_refstring

Route into the sandbox with this id or name instead of a fresh one; 409 resource_ref_ambiguous if the value is one sandbox's id and another's name. At most one of sandbox_id, sandbox_name, sandbox_ref.

new_sessionboolean
model'fable' | 'opus' | 'sonnet' | 'haiku' | 'gpt-5.6-sol' | 'gpt-5.6-terra' | 'gpt-5.6-luna' | 'gpt-5.5' | 'gpt-5.2' | 'null' nullable
effort'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'null' nullable
repo_urlstring
branchstring
new_branch_namestring

Response

A text/event-stream of the send. Frames are named by the SSE event: field: status, delta, terminal done (the full AgentSessionSendResponse), or error.

Changes

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property