Private Assets

⚡ Built-in — Platform Built-in

Keep project files off the public site and CDN, and share them with expiring, revocable links. Store a private file with upload_asset (private: true) and read it back with get_asset. Use this integration to move an asset between public and private, and to create, list and revoke share links. Paid plans.

⚡ Built-in — No Setup Required This integration is built into the WebsitePublisher platform. All endpoints are available immediately — no API key needed.

Endpoints (4)

POST set-visibility

Move an existing asset between public and private. private: true takes a public asset off the site and CDN (its public URL stops working; paid plans). private: false publishes a private asset again and ends its share links. The file is moved, never duplicated.

Field	Type	Required	Description
`slug`	string	✓ Yes	Asset path, e.g. "lists/leads.csv".
`private`	boolean	No	Required. true = make private, false = make public.

POST create-share

Create a download link for a private asset. The link expires (default 7 days), can be capped by downloads and revoked at any time. Returns the url once; give it to the user. Executables and archives cannot be shared by link. Paid plans.

Field	Type	Required	Description
`slug`	string	✓ Yes	Path of the private asset.
`expires_in_hours`	integer	No	Lifetime in hours (default 168 = 7 days, max 2160 = 90 days).
`max_downloads`	integer	No	Optional cap on downloads; the link stops after this many.
`label`	string	No	Who or what the link is for, shown in list-shares.

POST list-shares

List share links of this project, newest first: status (active, expired, exhausted, revoked), expiry, downloads. Never returns the link itself.

Field	Type	Required	Description
`slug`	string	No	Only links of this private asset.

POST revoke-share

End a share link at once. Allowed on every plan.

Field	Type	Required	Description
`share_id`	integer	✓ Yes	share_id from create-share or list-shares.

MCP Tool Names

When using this integration through an AI assistant (Claude, ChatGPT, Cursor, etc.), the endpoints are available as MCP tools:

Endpoint	MCP Tool Name
set-visibility	`private-assets_set_visibility`
create-share	`private-assets_create_share`
list-shares	`private-assets_list_shares`
revoke-share	`private-assets_revoke_share`

← Back to all integrations