Skip to main content
POST
Start a persistent worker session

Authorizations

X-Agentmark-App-Id
string
header
required

Application ID for tenant scoping. X-Outerlayer-App-Id is accepted as an equivalent header.

Authorization
string
header
required

API key (sk_agentmark_*)

Body

application/json
task_prompt
string
required

The session's first task.

Minimum string length: 1
agent
string

Agent id (default claude-code). One of: claude-code, codex, cursor, opencode

base_branch
string

Response

Session created; first turn dispatched.

data
object
required