Finalize Asset Upload (Platform MCP)
Completes a file upload started with get_asset_upload_url, creates the asset, and attaches it to an item's file column using the Platform MCP.
Use this tool to finalize a file upload and create the asset on monday.com. Call it after uploading the file to the presigned URL returned by get_asset_upload_url. It automatically attaches the uploaded asset to the specified file or doc column on an item and returns the created asset_id.
This tool runs against the monday.com dev (preview) API schema (
complete_upload). The underlying API is subject to change until it is promoted to a stable API version.
This is the final step of the upload flow:
- get_asset_upload_url — Get an
upload_idandupload_url. - Upload the file —
PUTthe file toupload_urland capture theETagresponse header. finalize_asset_upload← You are here — Complete the upload and attach the asset.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| uploadId | string | Yes | The upload_id returned by get_asset_upload_url. |
| etag | string | Yes | The ETag header value from the PUT response when uploading to the presigned URL. |
| boardId | string | Yes | The board's unique identifier. |
| itemId | string | Yes | The item's unique identifier. |
| columnId | string | Yes | The file or doc column's unique identifier to attach the uploaded asset to. |
Example
Finalize an upload and attach the file to an item's file column:
{
"uploadId": "upl_abc123",
"etag": "\"d41d8cd98f00b204e9800998ecf8427e\"",
"boardId": "1234567890",
"itemId": "987654321",
"columnId": "files"
}The tool returns the created asset's asset_id, filename, content_type, file_size, url, and filelink.
Programmatic equivalent
This tool maps to the complete_upload mutation on the monday.com dev (preview) API schema, followed by a change_column_value mutation to attach the asset. There is no stable public GraphQL equivalent for complete_upload yet. For working with files on the stable API, see Assets.
Updated about 4 hours ago
