Get an upload URL for a large file
create_upload_sessionFor files too large to send inline: reserves a link and returns a one-time upload_url. PUT the raw bytes there (e.g. give the user the returned curl command), then poll get_link with the slug (and manage_token) until status is "live".
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"filename": "<filename>"
},
"name": "create_upload_session"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| slug | No | Custom link name (3-40 letters, digits, dashes); available on plans with custom names. | |
| filename | Yes | Name of the file that will be uploaded, including extension. | |
| password | No | Visitors must enter this password to open the link; available on plans with password protection. | |
| size_bytes | No | Expected size, checked against your plan limit up front. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| curl | Yes | Ready-to-run command for the user. | |
| link | Yes | ||
| method | Yes | ||
| headers | Yes | ||
| max_bytes | Yes | ||
| expires_at | Yes | ||
| upload_url | Yes | One-time URL: PUT the raw file bytes here (no auth header needed). | |
| complete_url | No | When present: POST here (no body) after the PUT finishes. The curl command already does it. |