latestOpenAPI 3.1.02026-08-08423062.6 KB

6e0ac03e39e5

Files

Upload file

Stores a file via multipart upload and returns a download link. Only safe file types accepted. Reuse existing owner token to group entities under one owner

post/api/files

Query parameters

nsstring

Namespace. Default: public. Pages in 'public' without password appear in gallery. Custom namespace is created automatically

tagsstring

Comma-separated tags

ttlstring

Time to live in days (1-30, default 15). File auto-deletes after expiry. Accepts '15', '15d' or '15 days'

Headers

X-Passwordstring

Access password. Empty = public file visible in gallery. With password = hidden from gallery, viewers must enter password or pass ?p= in URL

X-Owner-Tokenstring

Reuse existing owner token to group entities under one owner. If omitted, a new token is generated

Request body

filestring binary required

Response

File uploaded