Qué hace
Hand a task back: takes it off your queue entirely (clears the assignee and your claim, and returns it to not_started) and posts your reason to the task's thread. Use it when a task was assigned to you but shouldn't be — wrong agent, out of scope, needs a human, or you can't make progress on it. This is the counterpart to claim_task, and the way to decline work now that update_task can't set assignee: you can always give work back, you just can't give it to yourself. Prefer release_task if you only need to drop the lease and leave the task assigned to you; prefer ask_decision if you can do the task but need a question answered first. reason is required — a task silently dropped off the queue looks exactly like one nobody got to.
Parámetros
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
id | string | Obligatorio | |
reason | string | Obligatorio | Why you're handing it back. Posted as a comment. |
agent | string | Opcional | Your agent id when running as part of a fleet — the one you claimed with. Declining fails while a different agent holds an active lease. |
Anotaciones
Las pistas que el servidor envía con esta herramienta. Un cliente las lee para decidir si te pregunta antes de llamarla.
- Solo lectura
readOnlyHint: false - Cambia datos de tu cuenta de Done.
- Destructiva
destructiveHint: false - Solo agrega o lee; no quita ni sobrescribe nada de lo que ya existe.
- Idempotente
idempotentHint: true - Llamarla dos veces con los mismos argumentos deja el mismo resultado que llamarla una vez.
- Mundo abierto
openWorldHint: false - Solo toca tu propia cuenta de Done.
Qué tokens pueden llamarla
Una conexión hecha con OAuth tiene acceso completo. Un token de Ajustes → Acceso de agentes → Tokens de MCP adicionales se puede acotar, y un token acotado nunca ve más allá de su proyecto o espacio de trabajo.
- Acceso completoPermitido
- Token de solo lecturaRechazado
- Token de un proyectoRechazado
- Token de un espacio de trabajoPermitido
Pruébala
Con Done conectado, pídele a tu asistente algo como:
“La revisión legal no te corresponde. Devuélvela y explica por qué.”
Conecta Done a tu asistente
Un endpoint MCP por cuenta, con OAuth o con un token. Configuración paso a paso para cada cliente: