Uploads

Get a one-time PUT URL for a large file

Reserves a link and returns upload_url. PUT the raw bytes there, then poll get_link.

post/upload-sessions

Request

  • Base URL: https://putit.online/api/v1
  • URL: https://putit.online/api/v1/upload-sessions
  • Auth: one of:
    • none
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://putit.online/oauth/authorize, token URL https://putit.online/oauth/token, scopes: links:read, links:write, account:read)

Request body

filenamestring required

Name of the file that will be uploaded, including extension.

size_bytesinteger

Expected size, checked against your plan limit up front.

slugstring

Custom link name (3-40 letters, digits, dashes); available on plans with custom names.

passwordstring

Visitors must enter this password to open the link; available on plans with password protection.

Response

OK

upload_urlstring required

One-time URL: PUT the raw file bytes here (no auth header needed).

method'PUT' required
headersobject required
max_bytesnumber required
expires_atstring required
complete_urlstring

When present: POST here (no body) after the PUT finishes. The curl command already does it.

curlstring required

Ready-to-run command for the user.

Changes

No recorded changes to this operation across all 1 revision of this API.