Fystash

Documentation

Dashboard

concepts

Rooms

A room is the run-scoped container for sandboxes, fabric, and drive.

Create a room before spawning sandboxes. Every sandbox, fabric message, and drive path is scoped to a room.

Create

MCP: room_create with a unique room_id (e.g. room-dash-<shorthex>).

REST:

curl -fsS -X POST "$FYSTASH_API/v1/rooms" \
  -H "Authorization: Bearer $FYSTASH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"room_id":"room-hello-1"}'

List / get / destroy

  • room_list / GET /v1/rooms
  • room_get / GET /v1/rooms/{room_id}
  • room_destroy / DELETE /v1/rooms/{room_id}

Destroy tears down sandboxes in the room. Prefer unique ids; do not reuse active room ids.

Quotas

Free and Starter orgs have soft caps on concurrent rooms. Check usage before large fan-outs.