> ## Documentation Index
> Fetch the complete documentation index at: https://namespace.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# devbox release

> Release an acquired Devbox so it can be reused.

Release the lease on a Devbox obtained with `devbox acquire`. Releasing makes the Devbox eligible for a later acquisition with the same tag. It does not expire the Devbox.

Identify the lease by Devbox name, lease ID, or both. When neither is supplied, the CLI prompts you to select one of your leased Devboxes.

## Usage

```bash theme={null}
devbox release [name] [flags]
```

## Examples

### Release by lease ID

```bash theme={null}
devbox release --lease_id=LEASE_xyz
```

### Release a named Devbox lease

```bash theme={null}
devbox release my-devbox --lease_id=LEASE_xyz
```

## Options

<ResponseField name="--lease_id" type="string">
  Release the lease ID printed by `devbox acquire`. The Devbox name is optional when this option is supplied.
</ResponseField>

<ResponseField name="--show-all" type="boolean" default="false">
  Include Devboxes created by other users when selecting a leased Devbox.
</ResponseField>

## Related topics

<Columns cols={2}>
  <Card title="Acquire a reusable Devbox" icon="rotate-cw" href="/docs/reference/devbox-cli/acquire">
    Obtain the lease that this command releases.
  </Card>

  <Card title="Delete a Devbox" icon="trash-2" href="/docs/reference/devbox-cli/delete">
    Expire a Devbox instead of returning it for reuse.
  </Card>
</Columns>