Files
Upload link
Someone without an account sending a file into your workspace through an upload link.
POST
https://app.getera.io/api/files/drop/{token}Link token
A link you create on the Files → Upload links tab looks like /uploads/<token>; that page sends files to this address. You can upload to the same address from your own interface or a script. To create a link and set its limits, see Upload links.
The upload is recorded as the member who opened the link, with their permissions, and shows in the activity feed as "upload link". A link can never grant more than its owner holds, and if the owner leaves the workspace the link stops working.
Authentication
The token in the address is enough. The token is the link itself: anyone who has it can send files.
Path parameter
| Name | Type | Required | Description |
|---|---|---|---|
token | string | Yes | The token in the link: /uploads/<token>. |
Body
multipart/form-data, one field:
| Name | Type | Required | Description |
|---|---|---|---|
file | file | Yes | The file to send. Its size and type must fit the link's settings. |
Example
curl -X POST https://app.getera.io/api/files/drop/UPLOAD_LINK_TOKEN \
-F "[email protected]"Response
{ "ok": true, "name": "invoice-october.pdf", "size": 184320 }Status 201.
Errors
| Status | Body | When |
|---|---|---|
400 | {"error": "No file was attached."} | No file field. |
404 | {"error": "This upload link is not valid."} | No such link. |
404 | {"error": "This upload link has been closed."} | The link was closed. |
409 | {"error": "This upload link has received all the files it accepts."} | The file count limit is reached. |
410 | {"error": "This upload link has expired. Ask for a new one."} | Expired. |
413 | {"error": "That file is larger than this link accepts."} | File too large. |
415 | {"error": "That kind of file is not accepted here."} | File type not allowed. |
429 | {"error": "Too many uploads from here. Please wait a little and try again."} | Too many uploads from the same address. |
503 | {"error": "This upload link cannot accept files at the moment."} | The link cannot take files right now (e.g. its owner lost the permission). |
500 | {"error": "The upload did not complete. Please try again."} | The upload did not complete. |