Create artifact upload

create_artifact_upload

Scrittura

Cosa fa

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).

Parametri

Nome	Tipo	Obbligatorio	Descrizione
`task_id`	`string`	Obbligatorio	The task the file belongs to
`label`	`string`	Obbligatorio	What the file is, as a human reads it — e.g. "Q3 report"
`filename`	`string \| null`	Facoltativo	What the downloaded file should be called. Advisory and sanitised before use — the extension comes from an allow-list, not from you.
`kind`	`string`	Facoltativo	"pdf" for a PDF; "binary" (the default) for anything else. Valori ammessi`pdfbinary`
`size_bytes`	`number`	Obbligatorio	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`	Facoltativo	To replace a file you already uploaded to this task: its artifact_id. Omit to attach a new file.

Annotazioni

Le indicazioni che il server invia con questo strumento. Un client le legge per decidere se chiederti il permesso prima di una chiamata.

Sola letturareadOnlyHint: false: Modifica dati nel tuo account Done.
DistruttivodestructiveHint: false: Aggiunge o legge soltanto; nulla di ciò che esiste viene rimosso o sovrascritto.
IdempotenteidempotentHint: false: Ogni chiamata può aggiungere qualcosa di nuovo, come un commento, un’esecuzione o un’attività.
Mondo apertoopenWorldHint: false: Tocca solo il tuo account Done.

Quali token possono chiamarlo

Una connessione fatta con OAuth ha accesso completo. Un token creato in Impostazioni → Accesso degli agenti → Token MCP aggiuntivi si può restringere, e un token ristretto non vede mai oltre il suo progetto o spazio di lavoro.

Accesso completoConsentito
Token di sola letturaRifiutato
Token per un progettoConsentito
Token per uno spazio di lavoroConsentito

Provalo

Con Done collegato, chiedi al tuo assistente qualcosa come:

“Allega il report in PDF all’attività della revisione trimestrale.”

Collega Done al tuo assistente

Un endpoint MCP per account, con OAuth o con un token. La configurazione passo passo per ogni client:

Panoramica della configurazione MCP →