docs: runbook section 5 lists a bot's token ids as svc (sage)

Darkwing's probe-s7f: svc-$BIZ revokes one bot token (204, then 401);
the owner gets 403. A plain GET /tokens shows only svc's own tokens, so
rotation names GET /tokens?owner_id=<bot id> for an old id. Decision 68
records the resolution.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
This commit is contained in:
2026-10-08 17:16:51 -05:00
co-authored by Claude Opus 5.5
parent 28fbdec97d
commit 67d29f7da5
2 changed files with 13 additions and 1 deletions
+6 -1
View File
@@ -354,7 +354,12 @@ role. The stack never writes this file.
definitions in section 3. Mint a new token for the same bot, update
`expires` in the business file, and restart the broker. Revoke the
old token while the svc header still exists:
`svc -X DELETE "$VK/api/v2/tokens/<old id>"`. Then finish with section
`svc -X DELETE "$VK/api/v2/tokens/<old id>"`. A revoke hits that one
token, and it gets 401 on its next request. `mint` printed the old
id. If you didn't keep it, list the bot's tokens as `svc-$BIZ`:
`svc "$VK/api/v2/tokens?owner_id=<bot id>" | jq -c '.[] | {id, title, expires_at}'`.
A plain `GET /tokens` lists only svc's own tokens, which is none, and
the owner's account gets 403 on the revoke. Then finish with section
4's `rm -f`, which deletes the header. The broker refuses to
start with a token past its `expires`, and it treats any 401 as a
refusal, never a retry.