Assets

request_asset_upload

Mint a Sentway upload session and return the URL a human should open in a browser to attach files. Returns { upload_url, token, expires_at, instructions }. Poll get_upload_result with the token to see when uploads finish processing. Sessions expire after 60 minutes. Requires editor role.

Behaviour

Effect: Write. It creates or updates data in the account.
Repeat calls: Not idempotent. Repeating the call can produce a further change.
Plan: Available on every plan, including free.

Parameters

Name	Type	Required	Description
purpose	string	No	Optional short note shown on the upload page telling the human what to upload (e.g. "hero images for the homepage"). Max 500 chars. Advisory only; not enforced.
expected_images	integer	No	Optional advisory count of image files (png/jpeg/webp/gif/svg) the human is expected to upload. Not enforced.
expected_docs	integer	No	Optional advisory count of document files (pdf) the human is expected to upload. Not enforced.

Returns

Name	Type	Description
upload_url	string	—
token	string	—
expires_at	timestamp	—
instructions	string	—
idempotency_replay	false	—

Using it

request_asset_upload is called by an AI assistant connected to Sentway over MCP, not by hand. Point the assistant at the Sentway MCP endpoint and complete the OAuth flow, and the tool becomes available in the same session as the other 38 Sentway tools. See connecting over MCP.