Create artifact upload

create_artifact_upload

Schreiben

Was es tut

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

Parameter

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

Annotationen

Die Hinweise, die der Server mit diesem Tool mitschickt. Ein Client liest sie, um zu entscheiden, ob er dich vor einem Aufruf fragt.

Nur lesenreadOnlyHint: false: Ändert Daten in deinem Done-Konto.
DestruktivdestructiveHint: false: Fügt nur hinzu oder liest; nichts Bestehendes wird entfernt oder überschrieben.
IdempotentidempotentHint: false: Jeder Aufruf kann etwas Neues hinzufügen, etwa einen Kommentar, einen Lauf oder eine Aufgabe.
Offene WeltopenWorldHint: false: Berührt nur dein eigenes Done-Konto.

Welche Tokens es aufrufen dürfen

Eine per OAuth hergestellte Verbindung hat vollen Zugriff. Ein Token aus Einstellungen → Agentenzugriff → Weitere MCP-Tokens lässt sich einschränken, und ein eingeschränktes Token sieht nie über sein Projekt oder seinen Workspace hinaus.

Voller ZugriffErlaubt
Token nur zum LesenAbgelehnt
Token für ein ProjektErlaubt
Token für einen WorkspaceErlaubt

Probier es aus

Sobald Done verbunden ist, sag deinem Assistenten zum Beispiel:

“Häng den PDF-Bericht an die Aufgabe zum Quartalsrückblick.”

Verbinde Done mit deinem Assistenten

Ein MCP-Endpunkt pro Konto, per OAuth oder Token. Die Einrichtung Schritt für Schritt für jeden Client:

Überblick über die MCP-Einrichtung →