Set bot rotation
Sets the bot's view rotation (look direction). Yaw is normalized to -180 to 180, pitch is clamped to -90 to 90. The action is queued and executed on the next game tick.
Sets the bot's view rotation (look direction). Yaw is normalized to -180 to 180, pitch is clamped to -90 to 90. The action is queued and executed on the next game tick.
Preferred API authentication. Use a JWT with the api audience.
In: header
Path Parameters
The UUID of the SoulFire instance containing the bot.
uuidThe profile UUID of the bot to rotate.
uuidRequest Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Horizontal rotation angle in degrees (yaw). Range: -180 to 180 (values outside this range are normalized). Direction mapping: 0 = South, 90 = West, -90 = East, +/-180 = North.
floatVertical rotation angle in degrees (pitch). Range: -90 to 90 (values outside this range are clamped). Direction mapping: -90 = looking up, 0 = horizon, 90 = looking down.
floatResponse Body
application/json
application/json
application/json
application/json
curl -X POST "http://127.0.0.1:38765/v1/instances/p0/bots/p1/rotation:set" \ -H "Content-Type: application/json" \ -d '{ "yaw": 0.1, "pitch": 0.1 }'{ "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": [ {} ]}How is this page?
Set movement state POST
Updates the bot's movement state (WASD, jump, sneak, sprint). Only specified fields are changed; omitted fields retain their current value. Movement persists until explicitly changed or reset. The action is queued and executed on the next game tick.
Submit dialog POST
Submits a dialog with input values. Used for dialogs containing text fields, checkboxes, dropdowns, or sliders. The dialog is closed after submission. Note: Full dialog response packets are not yet implemented; this clears local state.