Assets
request_asset_upload
Mint an upload session and return the URL a human opens in a browser to attach files. Poll get_upload_result with the returned token for processing status. Sessions expire after 60 minutes. 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 note shown on the upload page saying what to upload. Max 500 chars, advisory. |
| expected_images | integer | No | Advisory count of expected image files. Not enforced. |
| expected_docs | integer | No | Advisory count of expected pdf files. Not enforced. |
Returns
| Name | Type |
|---|---|
| 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 56 Sentway tools. See connecting over MCP.