Create artifact upload

create_artifact_upload

Escritura

Qué hace

Attach a real file to a task — a PDF, a screenshot, a spreadsheet, anything too large or too binary for an inline deliverable. Reserves a stored file on the task and returns a one-time upload_url. Then PUT the file's raw bytes to that URL with NO Authorization header (e.g. curl -X PUT --data-binary @report.pdf "<upload_url>"): the link itself is the credential, it works for one successful upload, and it expires 15 minutes after this call, so request it right before you upload. Once the PUT succeeds, record the file on the task with update_task as a deliverable {label, kind, artifact_id}, using the artifact_id returned here. To replace a file you already attached, pass its artifact_id — the deliverable keeps pointing at the newest upload. Refused for a read-only token, a task outside this token's project or workspace, a task in Trash, and a file past the size ceilings (25 MB per file, 100 MB across a task, 1 GB across the account).

Parámetros

Nombre	Tipo	Obligatorio	Descripción
`task_id`	`string`	Obligatorio	The task the file belongs to
`label`	`string`	Obligatorio	What the file is, as a human reads it — e.g. "Q3 report"
`filename`	`string \| null`	Opcional	What the downloaded file should be called. Advisory and sanitised before use — the extension comes from an allow-list, not from you.
`kind`	`string`	Opcional	"pdf" for a PDF; "binary" (the default) for anything else. Valores permitidos`pdfbinary`
`size_bytes`	`number`	Obligatorio	The file's exact size in bytes. The quotas are checked against it now, and the upload is refused if the bytes you PUT are larger.
`artifact_id`	`string \| null`	Opcional	To replace a file you already uploaded to this task: its artifact_id. Omit to attach a new file.

Anotaciones

Las pistas que el servidor envía con esta herramienta. Un cliente las lee para decidir si te pregunta antes de llamarla.

Solo lecturareadOnlyHint: false: Cambia datos de tu cuenta de Done.
DestructivadestructiveHint: false: Solo agrega o lee; no quita ni sobrescribe nada de lo que ya existe.
IdempotenteidempotentHint: false: Cada llamada puede agregar algo nuevo, como un comentario, una ejecución o una tarea.
Mundo abiertoopenWorldHint: 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 proyectoPermitido
Token de un espacio de trabajoPermitido

Pruébala

Con Done conectado, pídele a tu asistente algo como:

“Adjunta el informe en PDF a la tarea de la revisión trimestral.”

Conecta Done a tu asistente

Un endpoint MCP por cuenta, con OAuth o con un token. Configuración paso a paso para cada cliente:

Resumen de la configuración de MCP →