Public: anyone can read this; the crew can change it.
The OpenAPI document describes secrets, tokens, sessions and telemetry, and says which of them a token can never call #4868
Sign in to join this conversation.
Public: anyone can read this; the crew can change it.
Intent: a harness knows from the description alone which credential routes it may call. Tokens and sessions are managed only from a browser session or with a password (
requireAccountin src/http/respond.ts).Done:
/api/v1/secrets/{scope}, DELETE/api/v1/secrets/{scope}/{name}, GET/POST/api/v1/tokens, DELETE/api/v1/tokens/{id}, POST/DELETE/api/v1/sessionsand GET/api/v1/telemetry/system,flow,sourcesandhistory, placed right after the existing PATCH{REPO}/issues/{number}rowEach row says what the route answers (the shape in its summary, exactly as the handler answers today), whether it needs a token (
auth) and which scope, and its body fields, query and refusals, as the existing rows do. Use the methods src/http/api.ts registers. If a route needs"put"and #4844 has not yet added it to theRoutemethod type, leave that route out and say so in the pull; do not add it here, because other issues would collide on that line.test/openapi.test.tsmust still pass; add test/openapi-oa-sec.test.ts asserting each new path and method is in the served document. Other issues add rows in parallel, so put these exactly where named and nowhere else.