Run agent task
Runs a named, pre-built browser flow. List the available flows with GET /v1/agent/tasks first, and pass an unknown name to get 400. In async_mode the immediate response has ok: false with status: "pending", which is not a failure; check status first, then poll /v1/job/{job_id}.
Authorizations
Every request carries a bearer API key, which looks like ph_live_.... Keep keys server-side, because a key grants full control of your sessions. A missing header returns 401; an invalid or revoked key currently returns 403, so treat the two together as authentication failure.
Body
Response
Successful Response
Whether the flow succeeded. In async_mode this is false while status is pending, which is not a failure.
The flow's output.
The steps the flow took.
The error, when the flow failed.
Set only when async_mode was requested.
pending while an async run is in flight.