queue_complete
tools/call
Finishes the item with its result. A task: { summary, links?, moveTo?, requestReview? }; attach files you made with the Files tools to target { type: 'queue_item', id: itemId } first. A briefing: { kind: 'briefing', skill: { name: 'specify-briefing', version }, written, sources, podcast? } as the specify-briefing skill describes. INVALID_RESULT names the path to fix; send again with the same lease.
Scopes
read:task_queueclaim:task_queue
Only items for the person who made the key, in projects the key can read (read:projects for project items). Briefing items are read-only. Completing a task item moves and comments its task, which needs write:projects.
Inputs
- itemIdstringRequired
- The item's itemId (tq_...)
- leaseIdstringRequired
- The leaseId queue_claim returned
- resultobjectRequired
- idempotencyKeystringRequired
- A retry key you choose, 8 to 200 characters; the same call sent again with it changes nothing new
Returns
The completed item and its result. A call returns content[0].text with the JSON result and structuredContent.result with the same value.
Listed when
The key has read:task_queue; the tools that take work need claim:task_queue too.