Click container button

Clicks a container-specific action button. Used for: stonecutter recipes, enchanting, loom patterns, villager trades, beacon effects, crafter slot toggles, lectern page navigation. The action is queued and executed on the next game tick.

Authorization

AuthorizationBearer <token>

Preferred API authentication. Use a JWT with the api audience.

In: header

Path Parameters

instance_id*string

The UUID of the SoulFire instance containing the bot.

Formatuuid

bot_id*string

The profile UUID of the bot clicking the button.

Formatuuid

button_id*integer

The button ID to click. Valid values depend on container type:

Stonecutter: 0-99 (recipe index)
Enchanting table: 0-2 (enchantment slot)
Loom: 0-99 (pattern index)
Villager: 0 to (offer count - 1)
Beacon: mob effect registry ID, -1 for confirm
Crafter: 0-8 (slot toggle index)
Lectern: 1=prev page, 2=next page, 3=take book

Formatint32

Response Body

`application/json`

curl -X POST "http://127.0.0.1:38765/v1/instances/p0/bots/p1/container/buttons/p2:click"

{
  "success": true,
  "error": "string"
}

{
  "code": 0,
  "grpc-code": "string",
  "message": "string",
  "stack-trace": "string",
  "details": [
    {}
  ]
}

{
  "code": 0,
  "grpc-code": "string",
  "message": "string",
  "stack-trace": "string",
  "details": [
    {}
  ]
}

{
  "code": 0,
  "grpc-code": "string",
  "message": "string",
  "stack-trace": "string",
  "details": [
    {}
  ]
}

Click container button

Authorization

Path Parameters

Response Body

200application/json

401application/json

403application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`