MCP/Tools/Images/get_upload
get_upload

Check an upload link

Free

See whether the file for an upload link has arrived, and get its image id.

How it works

After create_upload_link: returns waiting, uploaded or expired. Once uploaded it returns the imageId and imageUrl to use in compose_ad, edit_image, create_share or as a generate_image reference.

Inputs

Name
Type
Required
Description
uploadToken
string
required
The uploadToken from create_upload_link.

Returns

{ status: 'waiting' | 'uploaded' | 'expired', imageId, imageUrl, expiresAt }

Examples

Pick up the dropped file

You say the photo is uploaded. The agent checks the link and carries on with the image id.

{
  "uploadToken": "<uploadToken>"
}