Skip to main content
POST
Take one action

Authorizations

Authorization
string
header
required

API token from Atlas Dashboard

Path Parameters

dive_id
string
required

Body

application/json
action
required

The action your agent takes — a plain string or a structured DiveAction.

turn
integer

Idempotency key: the turn this action answers. Replaying the same turn returns the same observation.

Response

Action applied.

Result of an action. If a flag trips or the budget/turn limit is reached, the dive auto-closes and a StageCard is returned instead.

observation
object

What the world returns after an action (the arrival state on open).

reading
object

Live sensing signal for the turn (present only when the Stage has a calibrated target).

running
object

Running totals across the dive.