Create artifact upload

create_artifact_upload

Escrita

O que faz

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

Nome	Tipo	Obrigatório	Descrição
`task_id`	`string`	Obrigatório	The task the file belongs to
`label`	`string`	Obrigatório	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`	Obrigatório	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.

Anotações

As indicações que o servidor envia com esta ferramenta. Um cliente as lê para decidir se pergunta a você antes de uma chamada.

Somente leiturareadOnlyHint: false: Altera dados da sua conta do Done.
DestrutivadestructiveHint: false: Só adiciona ou lê; nada do que já existe é removido ou sobrescrito.
IdempotenteidempotentHint: false: Cada chamada pode adicionar algo novo, como um comentário, uma execução ou uma tarefa.
Mundo abertoopenWorldHint: false: Só mexe na sua própria conta do Done.

Quais tokens podem chamá-la

Uma conexão feita com OAuth tem acesso total. Um token de Configurações → Acesso de agentes → Tokens MCP adicionais pode ser restringido, e um token restrito nunca enxerga além do seu projeto ou espaço de trabalho.

Acesso totalPermitido
Token somente leituraRecusado
Token de um projetoPermitido
Token de um espaço de trabalhoPermitido

Experimente

Com o Done conectado, peça ao seu assistente algo como:

“Anexe o relatório em PDF à tarefa da revisão trimestral.”

Conecte o Done ao seu assistente

Um endpoint MCP por conta, com OAuth ou com um token. A configuração passo a passo para cada cliente:

Visão geral da configuração do MCP →