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

nsc token refresh --token_id <id> --minimum_duration <duration>

Example

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

$ nsc token refresh --token_id tok_abc123def456 --minimum_duration 30d
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

--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 updated