Skip to main content
POST
Launch a worker run

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

What the agent should do.

Minimum string length: 1
agent
string

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

base_branch
string

Base branch (defaults to the app's tracked branch).

wall_clock_cap_s
integer

Wall-clock cap in seconds (default 1800).

Required range: 60 <= x <= 3600

Response

Run dispatched.

data
object
required