create-session

Create a session ID valid for 15 minutes and exchangeable exactly once for a 24-hour browser session. Redirect the end user to the returned URL.

Usage

unkey api portal create-session [flags]

string

required

The 3-64 character lowercase portal configuration slug.

string

required

The end user’s identifier in your system.

string[]

required

Capabilities: keys:read, keys:create, keys:reroll, and analytics:read.

bool

default:"false"

Create a preview session for testing.

Flag	Type	Description
`--root-key`	string	Override root key (`$UNKEY_ROOT_KEY`)
`--api-url`	string	Override API base URL (default: `https://api.unkey.com`)
`--config`	string	Path to config file (default: `~/.unkey/config.toml`)
`--output`	string	Output format, use `json` for raw JSON
`--body`	string	Send this JSON string as the request body. You cannot combine it with request-building flags.

unkey api portal create-session --slug=my-portal --external-id=user_123 --permissions=keys:read,keys:reroll