Farther ShoreDocs
Go to Farther Shore
Choose CLI and MCP operations
CLI reference
Platform operation catalog
MCP tool reference
Global CLI options
CLI: auth
CLI: login
CLI: logout
CLI: skills
CLI: docs
CLI: business
CLI: apply-timeline
CLI: proposal
CLI: env
CLI: plan
CLI: commercial-release
CLI: persona
farthershore personafarthershore persona bootstrapfarthershore persona listfarthershore persona loginfarthershore persona rotatefarthershore persona delete
CLI: usage
CLI: analytics
CLI: operations
CLI: organization
CLI: token
CLI: stripe
CLI: service-account
CLI: limit
CLI: audit-log
CLI: notifications
CLI: backend
CLI: frontend
CLI: webhook
CLI: agents
CLI: bulletin
CLI: promo-code
CLI: consumer
CLI: variables
CLI: agreements
CLI: tax-settings
CLI: resource-count
CLI: denial
CLI: dependents
CLI: workflow-control
CLI: automation
CLI: knowledge
CLI: link
CLI: unlink
CLI: create
CLI: import
CLI: build
CLI: validate
CLI: workflows
Status
Docs/Complete reference/CLI: persona

CLI: persona

Complete help for farthershore persona and every subcommand.

farthershore persona

Usage: farthershore persona [options] [command]

Mint and manage test-env personas (test API keys)

Options:
  -h, --help                                       display help for command

Commands:
  bootstrap [options] [businessIdOrName]           Issue a fresh fsk_test_ API key in a test environment
  list [options] [businessIdOrName]                List personas for a test environment
  login [options] [businessIdOrName] [personaId]   Open a browser signed in as a test persona
  rotate [options] [businessIdOrName] [personaId]  Rotate a persona's test API key and return the new key once
  delete [options] [businessIdOrName] [personaId]  Delete a temporary persona and its test-owned identity state
  help [command]                                   display help for command

farthershore persona bootstrap

Usage: farthershore persona bootstrap [options] [businessIdOrName]

Issue a fresh fsk_test_ API key in a test environment

Options:
  --env <env>              Environment name (must be test-strategy)
  --plan <planKey>         Plan key to assign (required when creating a
                           subscriber; e.g. starter)
  --display-name <name>    Persona display name
  --subscriber-id <id>     Join an existing persona test subscriber; omit to
                           create a new subscriber owned by this persona
  --account-role <role>    Subscriber-organization account role: owner, admin,
                           or member — the canonical lowercase vocabulary
                           (stored as Membership.role OWNER/ADMIN/VIEWER, where
                           member ⇢ VIEWER). Default: owner for a new
                           subscriber, member when joining
  --role <role...>         Subscriber-owned product role key(s); omit to use the
                           subscriber's configured default role
  --idempotency-key <key>  Required for this mutation. Generate it once and
                           reuse the exact value on retry.
  -h, --help               display help for command

farthershore persona list

Usage: farthershore persona list [options] [businessIdOrName]

List personas for a test environment

Options:
  --env <env>  Environment name
  -h, --help   display help for command

farthershore persona login

Usage: farthershore persona login [options] [businessIdOrName] <personaId>

Open a browser signed in as a test persona

Options:
  --env <env>  Environment name
  -h, --help   display help for command

farthershore persona rotate

Usage: farthershore persona rotate [options] [businessIdOrName] <personaId>

Rotate a persona's test API key and return the new key once

Options:
  --env <env>              Environment name
  --idempotency-key <key>  Required for this mutation. Generate it once and
                           reuse the exact value on retry.
  -h, --help               display help for command

farthershore persona delete

Usage: farthershore persona delete [options] [businessIdOrName] <personaId>

Delete a temporary persona and its test-owned identity state

Options:
  --env <env>  Environment name
  -h, --help   display help for command
PreviousCLI: commercial-releaseNextCLI: usage

On this page

farthershore personafarthershore persona bootstrapfarthershore persona listfarthershore persona loginfarthershore persona rotatefarthershore persona delete