SoulFire LogoSoulFire

Sleep in bed

Uses a reachable bed and completes only after the server confirms that the bot entered the sleeping state.

POST
/v1/instances/{instance_id}/bots/{bot_id}/actions:sleep

Uses a reachable bed and completes only after the server confirms that the bot entered the sleeping state.

Authorization

AuthorizationBearer <token>

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

In: header

Path Parameters

instance_id*string
Formatuuid
bot_id*string
Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

bed*

A block position in a specific dimension. Coordinates are Minecraft block integers, not chunk-relative.

hand?soulfire.v1.Hand

Which hand to use for an action. Mirrors Minecraft's main-hand / off-hand distinction.

Value in

  • "HAND_UNSPECIFIED"
  • "HAND_MAIN"
  • "HAND_OFF"

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:sleep" \  -H "Content-Type: application/json" \  -d '{    "bed": {      "x": 0,      "y": 0,      "z": 0    }  }'
{  "result": {    "actionId": "4a2794ff-94cb-4bac-8d36-d5fb36c563a0",    "status": "BOT_ACTION_STATUS_UNSPECIFIED",    "error": "string"  }}

How is this page?