Access and gates
upload_gate_asset_from_url
Add a logo or background image to a site's gate and paywall design from a public https URL. Returns the filename to put in the design (logo.primary_filename or background.filename) — reference that filename, never the source URL, and only on this site. SVG is sanitised, raster images are transcoded. 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 |
|---|---|---|---|
| request_id | string | Yes | Unique mutation ID. Reuse only to replay identical arguments. |
| site_id | uuid | Yes | Site UUID from list_sites. |
| kind | enum logo | background | Yes | Design slot; logo has a smaller size cap than background. |
| url | string | Yes | Public https URL Sentway fetches server-side (PNG, JPEG, WebP, SVG). Must be reachable without credentials; chat attachments, file://, data: URIs and private-network hosts are rejected. |
Returns
| Name | Type |
|---|---|
| site_id | string |
| kind | enum logo | background |
| filename | string |
| bytes | integer |
| idempotency_replay | false |
Using it
upload_gate_asset_from_url 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.