Sharing API

Share link endpoints for TMA Cloud.

Note: There is no share-specific limiter. Routes under /s/ use the general API limiter: 10000 requests per 15 minutes. Share links are unauthenticated, so the key is the IP address. Because these are the only routes reachable without a session, put a tighter limit in front of /s/ at your reverse proxy if you publish links widely. See Rate Limits.

Share Links (Public)

GET /s/:token

View a shared file or folder. A folder returns a listing page. A single-file share returns a landing page with a download button.

Folder rows are returned in keyset pages of 100 and the page loads the next set automatically near the end of the list. A client sending Accept: application/json receives { items, nextCursor }; pass that opaque value back as ?cursor=. limit may be 1–200.

Validation:

• token: Required. Must be a non-empty string.

Responses:

• 200 - HTML page with shared files
• 404 - Link does not exist or has been removed
• 410 - Link has expired

GET /s/:token/folder/:id

Browse a subfolder inside a shared folder. Returns the listing page for that folder. The folder must be part of the share.

The same cursor, limit, and JSON response behavior used by the root folder applies here.

Validation:

• token: Required. Must be a non-empty string.
• id: Required. Must be a non-empty string.

Responses:

• 200 - HTML page with the subfolder's contents
• 404 - Link not found, or the folder is not part of this share
• 410 - Link has expired

GET /s/:token/file/:id

Download an item from a share link. A file id downloads the file. A folder id downloads that folder's contents as a ZIP.

Validation:

• token: Required. Must be a non-empty string.
• id: Required. Must be a non-empty string.

Responses:

• 200 - File or ZIP download
• 404 - Link or file not found
• 410 - Link has expired

GET /s/:token/zip

Download a folder as ZIP from a share link.

Validation:

• token: Required. Must be a non-empty string.

Responses:

• 200 - ZIP archive download
• 404 - Link not found or not a folder
• 410 - Link has expired

Related Topics

• Files - File management endpoints
• Sharing Model - How sharing works