API reference: movement, tasks, and inventory

Before you start #

Every endpoint here works on one online account: /accounts/{id}/.... If the account is not running on a backend the answer is 404 not_assigned, so connect it first. These are the same controls as Control → Movement and Control → Inventory, described in Move accounts and run tasks and Use Chat, Control, and Point of View.

These are the same tiers as in the dashboard. On a lower plan the answer is 403 tier2_required or tier3_required.

Walk #

POST /accounts/{id}/move walks the account in a straight line relative to where it is facing. Tier 3.

curl -X POST https://dashboard.consoleclient.com/api/v1/accounts/[email protected]/move \
  -H "Authorization: Bearer $CC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"direction": "forward", "blocks": 5}'

POST /accounts/{id}/stop-moving stops the walk early. No body.

Both answer { "ok": true }. A missing or invalid field answers 400 invalid_request.

Aim the head #

POST /accounts/{id}/look turns the head to an exact angle. Tier 2.

{ "ok": true, "queued": 1 }

GET /accounts/{id}/look reads the current angle from the account. Tier 3, like the Head Position card in Control → Movement.

{ "connected": true, "yaw": -90, "pitch": 12.5 }

Reading waits for the account to answer. If it does not answer within four seconds the result is 504 command_timeout.

Pathing and mining tasks #

POST /accounts/{id}/task starts a task that keeps running until it finishes or you stop it. One task runs per account, and a task ends when the account disconnects. Every task endpoint needs Tier 3.

{
  "type": "goto",
  "params": { "x": 120, "y": 64, "z": -300, "sprint": true, "allowBreak": false },
  "humanize": true
}

humanize defaults to true and makes movement look less mechanical. An unknown type or a missing required param answers 400 invalid_request.

GET /accounts/{id}/task reports the running task.

{
  "active": true,
  "type": "goto",
  "desc": "goto",
  "startedAt": 1790000470000,
  "elapsedMs": 8200,
  "params": { "x": 120, "y": 64, "z": -300, "sprint": true, "allowBreak": false }
}

With no task running the answer is { "active": false }.

POST /accounts/{id}/task/stop stops the task. No body.

Read the inventory #

GET /accounts/{id}/inventory reads the inventory live from the account, plus any chest, shop, or menu it has open. Every inventory endpoint needs Tier 2.

{
  "inventory": {
    "accountId": "[email protected]",
    "username": "Steve",
    "edition": "java",
    "selectedHotbarSlot": 0,
    "player": {
      "id": 0,
      "type": "minecraft:inventory",
      "title": "",
      "slotCount": 46,
      "inventoryStart": 9,
      "inventoryEnd": 45,
      "items": [
        {
          "slot": 36,
          "type": 841,
          "name": "diamond_pickaxe",
          "displayName": "Diamond Pickaxe",
          "count": 1,
          "metadata": 0,
          "stackSize": 1,
          "customName": "",
          "lore": [],
          "enchantments": [{ "id": "efficiency", "level": 5 }]
        }
      ],
      "cursor": null
    },
    "container": null,
    "dialog": null
  }
}

Errors: 409 not_connected when the account is offline, 504 timeout when it did not answer in time, 404 not_assigned or account_missing when it is not running.

Click, drop, hold, and close #

Each of these answers with the fresh inventory in the same shape as above, so you can read the result of your click straight from the response.

curl -X POST https://dashboard.consoleclient.com/api/v1/accounts/[email protected]/inventory/click \
  -H "Authorization: Bearer $CC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slot": 13, "mouseButton": 0, "mode": 0}'