Files
bookhoard/docs/developer/api/queue/delete_queue_item.md
T
John O'Keefe eacc33bfac docs(conflicts,queue): Beam WO5 batch — 13 endpoints backfilled, registry pinned
Beam added frontmatter + provenance + labeled examples to the 7 conflict and
6 queue docs, fixing real field drift on the way (resolve response keys,
bulk result shape, dismiss-all deleted count, queue stats counts).

Claude registry verification found TWO Beam catches of Claude's own draft:
- queue routes use :device_id / :item_id params (registry first draft said :id)
- resolve_conflict DOES take a body (ConflictResolutionRequest) — registry
  first draft said nil
Both fixed; gate then surfaced one real Beam defect: example-request used a
nonexistent "resolution" field in resolve + bulk-resolve (real contract:
winner=<source|manual> with required manual_data for manual; strategy=
most_recent|highest_progress|manual). Fixed in the docs.

Pinned by type: ConflictListResponse, ConflictDetailResponse,
ConflictResolveResponse, BulkResolveRequest/Response, QueueStatsResponse,
ConflictResolutionRequest. dismiss-all deleted is an int count.
2026-10-24 15:37:45 -04:00

1.0 KiB

method, path, auth, area
method path auth area
DELETE /api/queue/items/:item_id jwt queue

Delete Queue Item

Delete a specific queue item.

Endpoint: DELETE /api/queue/items/:item_id Auth: Required

Path Parameters

Parameter Type Required Description
item_id string (UUID) Yes Queue item UUID

Request Headers

Header Type Required Description
Authorization string Yes Bearer token

Example Request

DELETE /api/queue/items/550e8400-e29b-41d4-a716-446655440000
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Response (204 No Content)

Queue item deleted successfully.

Error Responses

Code Description
401 Invalid or expired token
404 Queue item not found