CLI: token

farthershore token#

Usage: farthershore token [options] [command]

Manage organization-owned MakerTokens (signed-in user CLI sessions only)

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

Commands:
  permission-catalog [options]    List the exact permissions a human may
                                  delegate to an org MakerToken
  list [options]                  List organization-owned MakerTokens
  create [options] <name>         Create or request approval for an
                                  organization-owned MakerToken
  update [options] <tokenId>      Replace an org MakerToken's grants or request
                                  approval for the change
  approvals [options]             List pending org MakerToken approval requests
  approve [options] <approvalId>  Approve an org MakerToken request, optionally
                                  trimming its grants
  deny [options] <approvalId>     Deny an org MakerToken approval request
  rotate [options] <tokenId>      Rotate an org MakerToken and reveal its
                                  replacement once
  revoke [options] <tokenId>      Permanently revoke an org MakerToken
  help [command]                  display help for command

farthershore token permission-catalog#

Usage: farthershore token permission-catalog [options]

List the exact permissions a human may delegate to an org MakerToken

Options:
  --org       Administer an organization-owned MakerToken (requires a signed-in
              user CLI session).
  -h, --help  display help for command

farthershore token list#

Usage: farthershore token list [options]

List organization-owned MakerTokens

Options:
  --org             Administer an organization-owned MakerToken (requires a
                    signed-in user CLI session).
  --limit <count>   Page size (1-100; default 20).
  --offset <count>  Row offset for paging (default 0).
  -h, --help        display help for command

farthershore token create#

Usage: farthershore token create [options] <name>

Create or request approval for an organization-owned MakerToken

Options:
  --org                    Administer an organization-owned MakerToken (requires
                           a signed-in user CLI session).
  --permissions <json>     Exact platform permission set as JSON, for example
                           ["business:read"].
  --idempotency-key <key>  Stable replay key. Reuse the same value when retrying
                           this provisioning request.
  --businesses <ids>       Comma-separated business ids. Omit to authorize all
                           current and future businesses.
  -h, --help               display help for command

farthershore token update#

Usage: farthershore token update [options] <tokenId>

Replace an org MakerToken's grants or request approval for the change

Options:
  --org                    Administer an organization-owned MakerToken (requires
                           a signed-in user CLI session).
  --permissions <json>     Exact platform permission set as JSON, for example
                           ["business:read"].
  --idempotency-key <key>  Stable replay key. Reuse the same value when retrying
                           this provisioning request.
  -h, --help               display help for command

farthershore token approvals#

Usage: farthershore token approvals [options]

List pending org MakerToken approval requests

Options:
  --org       Administer an organization-owned MakerToken (requires a signed-in
              user CLI session).
  -h, --help  display help for command

farthershore token approve#

Usage: farthershore token approve [options] <approvalId>

Approve an org MakerToken request, optionally trimming its grants

Options:
  --org                    Administer an organization-owned MakerToken (requires
                           a signed-in user CLI session).
  --permissions <json>     Exact platform permission set as JSON, for example
                           ["business:read"].
  --idempotency-key <key>  Required for this mutation. Generate it once and
                           reuse the exact value on retry.
  -h, --help               display help for command

farthershore token deny#

Usage: farthershore token deny [options] <approvalId>

Deny an org MakerToken approval request

Options:
  --org       Administer an organization-owned MakerToken (requires a signed-in
              user CLI session).
  -h, --help  display help for command

farthershore token rotate#

Usage: farthershore token rotate [options] <tokenId>

Rotate an org MakerToken and reveal its replacement once

Options:
  --org                    Administer an organization-owned MakerToken (requires
                           a signed-in user CLI session).
  --idempotency-key <key>  Required for this mutation. Generate it once and
                           reuse the exact value on retry.
  -h, --help               display help for command

farthershore token revoke#

Usage: farthershore token revoke [options] <tokenId>

Permanently revoke an org MakerToken

Options:
  --org       Administer an organization-owned MakerToken (requires a signed-in
              user CLI session).
  --yes       Skip confirmation; required for this destructive action
  -h, --help  display help for command