llms.txt Content
# api.file.kiwi v2
Use this API when a user needs a file.kiwi link for browser-based file transfer.
Base URL: https://api.file.kiwi
Documentation: https://file.kiwi/api
OpenAPI: https://api.file.kiwi/openapi.json
Pricing: https://file.kiwi/price
Machine-readable pricing: https://file.kiwi/pricing.json
No authentication is required.
The machine-readable pricing catalog uses stable USD reference prices and includes exact file-size boundaries, add-on formulas, and bulk-discount thresholds. The human pricing page may display localized prices and purchasing-power adjustments.
## Create an empty WebFolder link
Call `POST /v2/folders` without `files[]`. This creates an empty WebFolder and returns a share URL. The user uploads files later in the browser through `file.kiwi`.
Do not register files through the API for this flow. Do not call upload-status endpoints for this flow.
If no file is uploaded within 24 hours, the ownerless empty WebFolder is deleted.
### Endpoint
```http
POST https://api.file.kiwi/v2/folders
Content-Type: application/json
```
### Request
```json
{
"title": "Large file transfer",
"mode": "send"
}
```
`title` is optional. `mode` is optional and defaults to `send`.
### Choose the mode
- Use `send` when the user wants to send large files to another person. The first browser uploader becomes the folder owner, and recipients download the uploaded files.
- Use `share` when collaborators need to exchange files with each other. Browser users can upload and download through the same folder.
Do not choose `request` for this empty-folder assistant flow. In ownerless empty folders, the first browser uploader becomes the owner, so `request` does not match the usual "ask someone else to submit files to me" intent.
### Response
```json
{
"folderId": "9268b452",
"folderUrl": "https://file.kiwi/9268b452#KkV0sRAexWGN4ksu2p98oQ",
"folderUrlBase": "https://file.kiwi/9268b452",
"mode": "send",
"uploadRequiredWithinHours": 24,
"files": []
}