1ctl token create

Creates a new API token. The token value is printed once at creation — copy it immediately. It will not be shown again.

Usage

1ctl token create <name>

Arguments

Argument	Required	Variadic
name	Yes	No

Flags

Flag	Type	Required	Default	Description
--expires	integer	No	0	Token expiry in days (0 for no expiry)
--help, -h	boolean	No	—	Show help

Examples

# Create a 90-day CI token
1ctl token create github-actions --expires 90

# Create a permanent token for a long-running service
1ctl token create monitoring-agent

Example output:

Token created: github-actions
ID:      tok_abc123
Expires: 2026-07-26

Token value (shown once — save it now):
sat_prod_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx