> ## 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.

# nsc token refresh

Extend the lifetime of a revocable token.

`nsc token refresh` ensures that an active token remains valid for at least the requested duration. It updates the existing token's expiration time without issuing a new bearer token. If the token already has more than the requested duration remaining, its expiration time does not change.

Expired and revoked tokens cannot be refreshed.

## Usage

```bash theme={null}
nsc token refresh --token_id <id> --minimum_duration <duration>
```

### Example

Ensure that a token remains valid for at least another 30 days:

```bash theme={null}
nsc token refresh --token_id tok_abc123def456 --minimum_duration 30d
```

```text nocopy Output theme={null}
Token tok_abc123def456 refreshed.

Token ID:     tok_abc123def456
Name:         ci-token
Description:  Token for CI jobs
Created At:   2026-06-01T10:30:00Z
Expires At:   2026-08-16T14:00:00Z
```

## Options

<h3 id="--token_id-id">
  \--token\_id \<id>
</h3>

The token ID to refresh. Token IDs begin with `tok_`. Required.

<h3 id="--minimum_duration-duration">
  \--minimum\_duration \<duration>
</h3>

The minimum amount of time that the token should remain valid. Specify a positive duration of up to 365 days. Supported units include `h` (hours), `d` (days), `w` (weeks), and `y` (years).

<h3 id="--output--o-format">
  \--output, -o \<format>
</h3>

Output format. One of `table` or `json`. Default is `table`.

## Related Topics

* [nsc token create](/docs/reference/cli/token-create) - Create a token
* [nsc token list](/docs/reference/cli/token-list) - List existing tokens
* [nsc token revoke](/docs/reference/cli/token-revoke) - Revoke a token