AMamika
AgentSessions

Send a message to a coding agent, creating a sandbox if needed

Changed on
post/api/v0beta1/agent-sessions

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
  • 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

Agent response.

session_idstring required
sandbox_idstring required
agent'claude' | 'codex' required
responsestring required
is_errorboolean required

True when the turn failed. The failure is still a 200: response carries the agent CLI's own message (e.g. "Not logged in · Please run /login").

is_new_sessionboolean required
created_sandboxboolean required

Changes

  • c46868fd7b41Revision changes
    • info

      added the new optional request property

    • info

      added the new optional request property

  • 98225c1e2de0Revision changes
    • info

      added the new optional request property

    • info

      added the new optional request property