Interact with block
Activates a specific block face without assigning placement semantics to the operation. This covers doors, buttons, beds, redstone controls, and modded interactive blocks.
Activates a specific block face without assigning placement semantics to the operation. This covers doors, buttons, beds, redstone controls, and modded interactive blocks.
Preferred API authentication. Use a JWT with the api audience.
In: header
Path Parameters
uuiduuidRequest Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Block to activate. Must be loaded and within interaction reach.
Face to click.
Value in
- "BLOCK_FACE_UNSPECIFIED"
- "BLOCK_FACE_DOWN"
- "BLOCK_FACE_UP"
- "BLOCK_FACE_NORTH"
- "BLOCK_FACE_SOUTH"
- "BLOCK_FACE_WEST"
- "BLOCK_FACE_EAST"
Which hand to use for an action. Mirrors Minecraft's main-hand / off-hand distinction.
Value in
- "HAND_UNSPECIFIED"
- "HAND_MAIN"
- "HAND_OFF"
Temporarily sneaks for this interaction. Useful when activating a block while holding an item whose normal use would take precedence.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/instances/497f6eca-6276-4993-bfeb-53cbbbba6f08/bots/497f6eca-6276-4993-bfeb-53cbbbba6f08/actions/interact-block" \ -H "Content-Type: application/json" \ -d '{ "position": { "x": 0, "y": 0, "z": 0 }, "face": "BLOCK_FACE_UNSPECIFIED", "hand": "HAND_UNSPECIFIED" }'{ "result": { "actionId": "4a2794ff-94cb-4bac-8d36-d5fb36c563a0", "status": "BOT_ACTION_STATUS_UNSPECIFIED", "error": "string" }}How is this page?