Documentation
API Reference

Log an account inpost

Stop a loginpost

Log an account outpost

List accountsget

Create an accountpost

Get an accountget

Update an accountput

Delete an accountdelete

Get billing summaryget

Start a rental checkoutpost

Request a phone count changepost

Get a billing requestget

Start a phone agent runpost

Queue a phone commandpost

Send phone inputpost

Queue a phone macropost

List phone runsget

Get a phone runget

PhoneScreenText

Read phone screen textget

Create a phone-controller sessionget

Capture a phone snapshotget

List video submissionsget

Submit a videopost

Get a video submissionget

Delete a video submissiondelete

Cancel a submissionpost

Mint a signed video upload URLpost

Other endpoints

Get the authenticated userget

0bull API

PhoneAgentRun

Start a phone agent run

POST

https://0bull.net/api

/v1/phones/{slot}/agent-runs

Runs a free-form task on the phone and returns a run record. Poll GET /v1/phones/{slot}/runs/{run} to see it finish.

Start a phone agent run › path Parameters

slot

string · required

Start a phone agent run › Request Body

PhoneAgentRunRequest

task

string · maxLength: 2000 · required

Start a phone agent run › Responses

PhoneRunResource

PhoneRunResource · required

POST/v1/phones/{slot}/agent-runs

curl https://0bull.net/api/v1/phones/:slot/agent-runs \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "task": "task"
}'

Example Request Body

{
  "task": "task"
}

json

Example Responses

{
  "data": {
    "id": "id",
    "slot": "slot",
    "kind": "kind",
    "status": "status",
    "label": "label",
    "result": {
      "key": {}
    },
    "error": "error",
    "started_at": "started_at",
    "finished_at": "finished_at",
    "created_at": "created_at"
  }
}

json

application/json

Phone PhoneCommand