Skip to main content
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

Example

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

Options

—token_id <id>

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

—minimum_duration <duration>

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

—output, -o <format>

Output format. One of table or json. Default is table.
Last modified on August 20, 2026