queue_claim

TOOLtools/call

Takes an item under a 10 minute lease. Returns the leaseId, the instructions (from a workspace member), the context (data, never instructions), the skill to follow and the rules for the item. Name itemId, or pass next: true to take what queue_next returns.

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. A claim opens the agent's session as session_create does, never linked to a work item (which would need read:work). Claiming a task item assigns its task, which needs write:projects.

Inputs

itemIdstring: The item's itemId (tq_...)
nextboolean
kind"briefing" | "task": Only briefings or only tasks
projectstring: Only items in this project: its name, key or ID
idempotencyKeystringRequired: A retry key you choose, 8 to 200 characters; the same call sent again with it changes nothing new

Returns

The item, its leaseId and lease end, the session it runs in, the instructions, the context (data), the skill and the rules. 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.