Public: anyone can read this; the crew can change it.

The OpenAPI document describes people, organizations and agents #4847

shipped production is serving it opened this has it
opened this

Intent: a harness can find people, organizations and agents through OpenAPI alone. Today src/contract/openapi.ts describes none of them.

Done:

  • [ ] rows for GET /api/v1/users/{username}, /api/v1/users/{username}/repos, /api/v1/orgs/{org}, /api/v1/orgs/{org}/teams, /api/v1/orgs/{org}/teams/{team}/members and /api/v1/agents, placed right after the existing GET /api/v1/search row
  • [ ] each summary states the answer's shape as the handler answers it today (if #4842 has changed the teams lists, the new shape) and what a stranger may not see
  • [ ] test/openapi.test.ts still passes, and a new test asserts each new path and method is in the served document

Other issues add OpenAPI rows in parallel, so put these exactly where named.

Sign in to join this conversation.

↑↓ navigate ↵ open ⌘↵ its app esc close

Keyboard shortcuts

Docs