> ## Documentation Index > Fetch the complete documentation index at: https://docs.idyl.network/llms.txt > Use this file to discover all available pages before exploring further. # idyl fleet-lease > Manage leased fleet capacity View and manage this account's leases on provider-operated capacity. A lease entitles you to deploy workloads against capacity a provider creates and runs for you. The fulfilling fleet stays the provider's: it never appears among your own fleets and may be replaced without changing the lease. A lease's terms are settled when it is created. Provider, capacity, term, and pricing are what you committed to and cannot be changed; the subnet the lease serves is set once, and cancelling is the only way to release it. Leases carry a name you choose and a 12-digit ID the platform assigns. Commands address a lease by its ID; the name is what a manifest matches on. ## Usage ```bash theme={null} idyl fleet-lease ``` ## Aliases * `fleet-leases` * `lease` * `leases` ## Commands | Command | Description | | ---------------------------- | -------------------------------------------- | | `idyl fleet-lease cancel` | Cancel a fleet lease | | `idyl fleet-lease events` | Show what has been observed about a lease | | `idyl fleet-lease get` | Get a fleet lease, or list them | | `idyl fleet-lease rate-card` | Show the published price for leased capacity | | `idyl fleet-lease usage` | Show a lease's metered machine time | ## Inherited flags | Flag | Description | | ------------------------------------ | ------------------------------------------------------------------ | | `-a , --account-id ` | Account ID to use, overriding the current context. | | `-c , --context ` | Use the named context for this command. | | `--homedir ` | Override the configuration directory. Defaults to \~/.config/idyl. | | `-n , --namespace ` | Namespace to address, overriding the entered context. | | `--network ` | Override the Network for this command. | | `-p , --profile ` | Override the access profile for this command. | | `-s , --subnet ` | Subnet to use for this command, overriding the current context. | | `--workspace ` | Workspace within the namespace, overriding the entered context. | ## Examples ```bash theme={null} idyl fleet-lease list idyl fleet-lease get idyl fleet-lease rate-card idyl fleet-lease events idyl fleet-lease usage --start 2026-08-01T00:00:00Z --end 2026-09-01T00:00:00Z idyl fleet-lease cancel ``` ## Subcommand reference ### `idyl fleet-lease cancel` Cancel a fleet lease and release the capacity serving it. Cancellation is asynchronous: the lease stops placement, drains its workloads, and terminates through its status phases rather than disappearing on request. It is also the only way to release the subnet a lease serves, because a lease's subnet is set once. #### Usage ```bash theme={null} idyl fleet-lease cancel [flags] ``` #### Flags | Flag | Description | | -------------------------------- | --------------------------------------------------- | | `-o , --output ` | Output format: table, json, yaml. Default: `table`. | | `-y, --yes` | Skip confirmation prompts. | #### Examples ```bash theme={null} idyl fleet-lease cancel ``` ### `idyl fleet-lease events` Show a lease's observed history, oldest first. A lease's status says whether the capacity it entitles you to is serving. Its events say what happened on the way: the terms being accepted, capacity being built, machines that started and never joined, the lease being fulfilled, the steps of it winding down. The fulfilling fleet belongs to the provider, so this is the consumer's view of that history: you learn that capacity was refused and which class of refusal it was, never the provider's account, its roles, or text its cloud wrote. Identical consecutive observations are collapsed into one row that counts up. Use --watch to keep reading. Following resumes from the position each page ended at, so nothing is read twice and nothing is missed. #### Usage ```bash theme={null} idyl fleet-lease events [flags] ``` #### Flags | Flag | Description | | -------------------------------- | ------------------------------------------------------------------------------- | | `--limit ` | Maximum events to return per page; the platform may return fewer. Default: `0`. | | `-o , --output ` | Output format: table, json, yaml. Default: `table`. | | `-w, --watch` | Keep reading, printing events as they are observed. | #### Examples ```bash theme={null} idyl fleet-lease events idyl fleet-lease events --watch idyl fleet-lease events --limit 20 -o json ``` ### `idyl fleet-lease get` Get one fleet lease, or list the account's leases. With no argument, lists every lease the account holds. With a 12-digit lease ID, shows that lease: the terms it was signed with, the subnet it serves, and the fleet currently fulfilling it. #### Usage ```bash theme={null} idyl fleet-lease get [lease-id] [flags] ``` #### Aliases * `list` * `ls` #### Flags | Flag | Description | | -------------------------------- | ------------------------------------------------------------------------------------------------------------------ | | `-o , --output ` | Output format: table, json, yaml, or manifest (the resource as a manifest `idyl apply` accepts). Default: `table`. | #### Examples ```bash theme={null} idyl fleet-lease list idyl fleet-lease get ``` ### `idyl fleet-lease rate-card` Show the platform's current published price for leased fleet capacity. The card prices one capacity shape — a cloud, a region, and an instance type — per entry. A lease must state the card's price for the shape it asks for, and the accepted price is then locked to that lease for its whole life: republishing the card reprices new leases only. A shape the card does not price cannot be leased. #### Usage ```bash theme={null} idyl fleet-lease rate-card [flags] ``` #### Flags | Flag | Description | | -------------------------------- | --------------------------------------------------- | | `-o , --output ` | Output format: table, json, yaml. Default: `table`. | #### Examples ```bash theme={null} idyl fleet-lease rate-card idyl fleet-lease rate-card -o json ``` ### `idyl fleet-lease usage` Show the machine time one lease metered over a window. Both bounds are required and neither is defaulted. Usage of an unbounded window has no meaning while machines are still running, and a window the caller did not choose is a number they would have no reason to trust. Times are RFC 3339. The start is inclusive and the end is exclusive, so a machine launched before the window or still running past its end reports only the part that falls inside. The rate shown is the one the lease locked when it was signed, echoed so the metered hours can be read against the price they meter at. It is not a charge: what a lease is invoiced is settled by billing. #### Usage ```bash theme={null} idyl fleet-lease usage [flags] ``` #### Flags | Flag | Description | | -------------------------------- | ---------------------------------------------------- | | `--end ` | Required. End of the window, exclusive (RFC 3339). | | `-o , --output ` | Output format: table, json, yaml. Default: `table`. | | `--start ` | Required. Start of the window, inclusive (RFC 3339). | #### Examples ```bash theme={null} idyl fleet-lease usage --start 2026-08-01T00:00:00Z --end 2026-09-01T00:00:00Z ```