Custom page via API

You can usually build a branded download page in the app. Your program or AI agent can do the same through the API: create a page and publish it at your link, with no manual setup.

Agency plan

What it does

Every uploaded file has a download link. Use the API to attach a custom page that visitors see across the full screen before downloading. This is useful for creating pages automatically or asking an AI agent to build them. We handle safe, reliable display; you provide the page content.

Before you start

Agency plan. The API is included.
API key. Generate one below and include it with each request. The key replaces sign-in; you do not send a password.
File ID. Upload a file and open its details. The ID is in the address: …/files/ID.

An API key is included in the Agency plan. Once it is active, generate your key here with one click.

Get Agency

Calling the API

Send one POST request. Include the key in the Authorization.

POST https://souborovna.cz/api/campaign/custom-html

Headers

Authorization: Bearer <your key>
Content-Type: application/json

Request body (JSON)

Field	Type	Description
`fileId`	string	ID of the file to attach the page to. Required.
`html`	string	Complete page HTML. Maximum 1 MB.
`publish`	boolean	`true` publishes the page immediately. If omitted, the page is saved as a draft.

Example

curl -X POST https://souborovna.cz/api/campaign/custom-html \
  -H "Authorization: Bearer sbrvn_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "fileId": "cmr661cza0000e8hkkgx8wgrw",
    "html": "<!doctype html><html><body>Hello!</body></html>",
    "publish": true
  }'

Response

{
  "ok": true,
  "slug": "s6nkd6n3vdjhpykf",
  "url": "/f/s6nkd6n3vdjhpykf",
  "published": true
}

url is the page address without a domain. Add https://souborovna.cz before it to share the link.

For AI agents

An agent, such as Claude Code, can generate HTML tailored to the file content and publish it with one call. The customer does not need to write code or insert the page manually; the link is immediately live.

Machine-readable documentation: souborovna.cz/en/api-docs.txt — send this link to your agent so it can read the API documentation.

Get the Agency plan Have a question? Contact us