complete_attachment

Access and behavior

Write or Administrator OAuth consent and a member/administrator team role are required. Tools are listed and callable only when the current grant and role permit them.

Checks byte length, detected MIME/signature and optional SHA-256. Mill copies verified bytes to a final object. An expired upload returns 410 UPLOAD_EXPIRED; start a new upload.

Arguments

Argument	Required	Type or meaning
`taskId`	Yes	Task UUID, not its human identifier such as ENG-1.
`attachmentId`	Yes	uuid
`idempotencyKey`	No	One logical mutation key, reused unchanged on retries. MCP forwards it as the REST Idempotency-Key header.

Complete input schema

{
  "type": "object",
  "properties": {
    "taskId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "attachmentId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "idempotencyKey": {
      "type": "string",
      "minLength": 8,
      "maxLength": 128
    }
  },
  "required": ["taskId", "attachmentId"],
  "additionalProperties": false
}

Example call

The client initializes the MCP connection before sending this JSON-RPC call. Example records are fictional.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "complete_attachment",
    "arguments": {
      "taskId": "22222222-2222-4222-8222-222222222222",
      "attachmentId": "44444444-4444-4444-8444-444444444444",
      "idempotencyKey": "restore-report-complete-001"
    }
  }
}

Example result

Mill returns this object in structuredContent and normally a JSON text content block (large responses may shorten the text block). A tool failure sets isError; never treat an error as a completed mutation.

{
  "attachment": {
    "id": "44444444-4444-4444-8444-444444444444",
    "taskId": "22222222-2222-4222-8222-222222222222",
    "fileName": "restore-report.pdf",
    "contentType": "application/pdf",
    "sizeBytes": 2048,
    "createdBy": "66666666-6666-4666-8666-666666666666",
    "createdAt": "2027-01-18T09:30:00.000Z"
  }
}

Connect a client

MCP reference

API Reference

complete_attachment

Workflow

Access and behavior

Arguments

Example call

Example result

​Workflow

​Access and behavior

​Arguments

​Example call

​Example result

​Related reference

Workflow

Access and behavior

Arguments

Example call

Example result

Related reference