Create an email image upload link
lnkdrp_create_email_asset_upload_linkCreates a one-time page on the LinkDrop site where the signed-in person adds one image for HTML email templates (a GIF, PNG, JPEG or WebP file, up to 25 MB) from their own browser. This is the route for an image attached in a chat: a chat attachment has no public address for sourceUrl, and a real image is far too long to copy into dataBase64. Works in every client, with no network access from the agent's environment; needs the person to open the link. The image is checked and stored exactly as lnkdrp_upload_email_asset stores one: the type is read from the file's bytes (SVG and other types are refused), an image up to 10 MB is kept as it is and a bigger one is made smaller to fit, a PDF or other document is refused with a sentence saying to share it as a link, and the workspace's 200-image cap and upload limits apply; the page shows the workspace's limits, and a refused file leaves the link working for another, with a note saying the limit and what to do. name becomes the image's name and alt text; without it the file's name is used. The link works once, for 60 minutes, only for the LinkDrop account this connection acts as, in this workspace, and stops working if this connection's key or sign-in is revoked. Returns { uploadLinkId, url, expiresAt, kind, name, status, next }; lnkdrp_check_upload_link with uploadLinkId answers asset { assetId, url, imgTag, ... } once status is ready. At most 10 upload links per person wait unused in a workspace at once, PDF and image links together (rate_limited).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | A name for the image (1-120 characters); its alt text in imgTag. Without it, the file's name. | |
| idempotencyKey | No | Optional. Without it, an identical call from this connection within 10 minutes returns the upload link the first call made (replayed: true) instead of making another, so a retry after an error or a dropped connection makes no duplicate. A key holds that promise for 24 hours; a new key makes a second upload link with identical settings. |