docs(api-tokens): deep rewrite for v1, expand to fleet automation guide (#1140)

Browse Source

Rewrite docs/features/api-tokens.mdx (115 → 442 lines) as a full
product + technical guide: mental model, scope ladder, prerequisites,
step-by-step usage with HTTP/WS/multi-node examples, complete universal-
restriction table, cross-node proxy behaviour, lifecycle, rate-limit
ceiling, security model, limitations, three example workflows,
troubleshooting accordion, FAQ accordion.

Replace the single populated-list screenshot with five captured against
production: empty state, create form, reveal banner (token value
redacted), populated list with all three scope variants, revoke modal.

Sibling-doc edits keep tier statements coherent now that API tokens are
available on every tier:
- docs/api-reference/overview.mdx: drop the Admiral-only Note callout,
  drop API Tokens from the Admiral-gated license-tier table, correct
  the rate-limit table to say tokens are keyed per-credential
- docs/features/overview.mdx: drop the "Admiral only." sentence
- docs/security.mdx: drop "Admiral tier.", move API tokens row to every
  tier in the security matrix, repoint image to the new populated shot

...

This commit is contained in:

Anso

2026-05-21 21:20:59 -04:00

committed by GitHub

parent dc8a368785

commit be22e3ded1

10 changed files with 398 additions and 80 deletions

Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL

Download Patch File Download Diff File Expand all files Collapse all files

docs/images/api-tokens/api-tokens-create-form.png

BIN

Binary file not shown.

Side by Side After Width:  |  Height:  |  Size: 93 KiB

docs/images/api-tokens/api-tokens-empty-state.png

BIN

Binary file not shown.

Side by Side After Width:  |  Height:  |  Size: 87 KiB

docs/images/api-tokens/api-tokens-overview.png

BIN

Binary file not shown.

Side by Side Before Width:  |  Height:  |  Size: 56 KiB

docs/images/api-tokens/api-tokens-populated.png

BIN

Binary file not shown.

Side by Side After Width:  |  Height:  |  Size: 102 KiB

docs/images/api-tokens/api-tokens-reveal-banner.png

BIN

Binary file not shown.

Side by Side After Width:  |  Height:  |  Size: 97 KiB

docs/images/api-tokens/api-tokens-revoke-modal.png

BIN

Binary file not shown.

Side by Side After Width:  |  Height:  |  Size: 77 KiB