CLICommands
lease
snug lease <COMMAND>Lease exclusive, time-bound access to unique resources.
Subcommands
| Command | What it does |
|---|---|
resources | Leasable resource administration |
acquire | Acquire a lease for a resource |
status | Show lease status for a resource |
renew | Renew an active lease |
release | Release an active lease |
transfer | Transfer an active lease to another holder |
bookings | Booking management |
waiting-room | List the waiting room for a resource (admin) |
validate | Validate a lease id and fencing token |
history | List lease history for a resource |
Run snug lease <command> --help for that command's own options.
The global options apply everywhere.
Examples
snug lease resources create --kind world_instance --display-name "World 123" --transferable
snug lease resources get <RESOURCE_ID>
snug lease acquire <RESOURCE_ID> --duration 1h
snug lease acquire <RESOURCE_ID> --duration 1h --metadata purpose=world_publish --on-conflict join-waiting-room
snug lease status <RESOURCE_ID>
snug lease renew <RESOURCE_ID> --lease lse_01JLEASE --fencing-token 184 --duration 30m
snug lease release <RESOURCE_ID> --lease lse_01JLEASE --fencing-token 184
snug lease transfer <RESOURCE_ID> --lease lse_01JLEASE --fencing-token 184 --to-holder agent_99
snug lease bookings create <RESOURCE_ID> --starts-at 2026-06-15T10:00:00Z --duration 1h
snug lease bookings list <RESOURCE_ID>
snug lease bookings cancel <RESOURCE_ID> --booking book_01JBOOK
snug lease waiting-room <RESOURCE_ID>
snug lease validate <RESOURCE_ID> --lease lse_01JLEASE --fencing-token 184 --machine world_lifecycle --transition publish
snug lease history <RESOURCE_ID> --page-size 20Next
- lease guide - what the service does and when to reach for it.
- API reference - every endpoint these commands call.
- CLI reference - global options, output modes, and exit codes.