Skip to content

docs(api): the Workspace Files routes are uncatalogued in api-endpoints.md #2599

Description

@AndriiPasternak31

What

docs/memory/architecture/api-endpoints.md is the API catalog, and three live Workspace file routes have never had a row in it:

  • GET /api/enterprise/client-portal/agents/{name}/documents — the agent-shared file list the rail's Files tab renders
  • POST /api/enterprise/client-portal/agents/{name}/documents — the client upload (per-client inbox, quota-gated)
  • GET /api/enterprise/client-portal/agents/{name}/uploads — the inbox listing (_read_inbox, a docker exec)

They predate #2582; the drift is pre-existing.

Why it wasn't fixed in #2582

Ruled out at that plan's Stage 2 gate (Decision 19) on two grounds: RoE #2 (minimal necessary changes — the backfill is unrelated to the three defects), and that every doc line in a PR sitting inside a serialized nine-issue merge lane is rebase surface for the six PRs behind it. #2582 catalogued only the routes it added (GET/DELETE .../uploads/{filename}, DELETE .../documents/{file_id}) plus the HEAD /api/files/{id} row it needed.

The lane closes when #2559 (step 7) merges, after which this is a clean standalone docs PR.

Scope

One table block in api-endpoints.md, in the existing row format. Worth checking the same section for other Workspace routes added since ent#475 while in there — this is a sweep, not a single row.

🤖 Generated with Claude Code

https://claude.ai/code/session_01HxW9tCTd3RnrWrxN8Yk8Bq

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    complexity-lowComplexity: low (board points 1-3)priority-p3Nice-to-havestatus-readyGreenlit and ready for development (vetted; counterpart to status-incubating)theme-devexTheme: DevExtype-docsDocumentation

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions