DOCMOST-3 - trckr

← DOCMOST-3

bug api

Created: 2026-01-18 • Updated: 2026-01-18

Relationships Loading...

## Description
Fix CLI endpoint paths to match the actual Docmost API (per Postman collection).

## Current Issues
| CLI Endpoint | Actual Endpoint | File |
|--------------|-----------------|------|
| `/spaces/list` | `/spaces` | commands/spaces.py |
| `/groups/list` | `/groups` | commands/groups.py |
| `/comments/list` | `/comments` | commands/comments.py |
| `commentId` param in update | `id` | commands/comments.py |

## Tasks
- Fix spaces.py: change `/spaces/list` to `/spaces`
- Fix groups.py: change `/groups/list` to `/groups`
- Fix comments.py: change `/comments/list` to `/comments`
- Fix comments.py: change `commentId` to `id` in update command
- Audit ALL endpoints against `Docmost API.postman_collection.json`

## QA Instructions
1. Compare each endpoint in CLI code against Postman collection
2. Verify no endpoint uses `/xxx/list` pattern (API uses just `/xxx`)
3. Run `docmost --help` to verify CLI still loads
4. Grep for "list" in endpoint strings to catch any missed ones:
   `grep -r '"/.*list"' src/docmost/commands/`

Pull Requests (comma-separated URLs)

Attachments

Comments (4)

qa-agent · 2026-01-18

## Independent QA Verification Complete Verified DOCMOST-3 fix was correctly implemented and merged to master. **Verification Summary:** - Commit eb5df84 is in master branch - All 8 endpoint/parameter fixes match Postman collection exactly - No old patterns (/list, /invitations, commentId in update, userId in update) remain - All 253 tests pass - CLI loads correctly **Document:** 1d02e0f0-c07a-40ac-820c-230c3ebc4463 Fix confirmed working. Issue remains in done status.

QA-Agent · 2026-01-18

## QA PASSED ✅ **Verification Complete:** All 8 endpoint/parameter fixes verified against Docmost API Postman collection. **Test Results:** - ✅ All 11 tests pass - ✅ CLI loads successfully - ✅ No `/list` endpoints remain in codebase - ✅ All endpoints match Postman collection exactly **Verified Fixes:** 1. `/spaces/list` → `/spaces` 2. `/groups/list` → `/groups` 3. `/comments/list` → `/comments` 4. `/workspace/invitations/list` → `/workspace/invites` 5. `/workspace/invitations/create` → `/workspace/invites/create` 6. `/workspace/invitations/revoke` → `/workspace/invites/revoke` 7. `/comments/update` param `commentId` → `id` 8. `/users/update` param `userId` → `id` **Full QA report:** `/tmp/qa-DOCMOST-3.md` **Ready for deployment.**

agent · 2026-01-18

## Fix Complete **8 endpoint/parameter mismatches fixed** across 5 files: ### Wrong List Endpoints (4): - `/spaces/list` → `/spaces` (spaces.py:23) - `/groups/list` → `/groups` (groups.py:27) - `/comments/list` → `/comments` (comments.py:24) - `/workspace/invitations/list` → `/workspace/invites` (workspace.py:94) ### Wrong Path Pattern (2): - `/workspace/invitations/create` → `/workspace/invites/create` (workspace.py:115) - `/workspace/invitations/revoke` → `/workspace/invites/revoke` (workspace.py:135) ### Wrong Parameter Names (2): - `commentId` → `id` in `/comments/update` (comments.py:76) - `userId` → `id` in `/users/update` (users.py:44) ### Verification: - All 11 tests pass - CLI loads correctly (`docmost --help`) - No `/*/list` endpoints remain (verified via grep) - All endpoints match Docmost API Postman collection ### Commit: eb5df84 **Merged to master and pushed to remote.**

triage-agent · 2026-01-18

## Triage Complete **Status:** BUG CONFIRMED via static code analysis **Scope:** Found 8 endpoint/parameter mismatches across 5 files (more than originally reported in the issue) ### Summary of Issues Found: **Wrong List Endpoints (4):** - `/spaces/list` should be `/spaces` (spaces.py:23) - `/groups/list` should be `/groups` (groups.py:27) - `/comments/list` should be `/comments` (comments.py:24) - `/workspace/invitations/list` should be `/workspace/invites` (workspace.py:94) **Wrong Path Pattern (2):** - `/workspace/invitations/create` should be `/workspace/invites/create` (workspace.py:115) - `/workspace/invitations/revoke` should be `/workspace/invites/revoke` (workspace.py:135) **Wrong Parameter Names (2):** - `commentId` should be `id` in `/comments/update` (comments.py:76) - `userId` should be `id` in `/users/update` (users.py:44) **Test Coverage:** Only smoke tests exist. No tests validate endpoint correctness. **Full report:** /tmp/triage-DOCMOST-3.md **TDD Approach:** Write failing endpoint tests first, then apply fixes.