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".
Input Schema
TableJSON 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
TableJSON 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. |