Uploads

Upload a file

Put a file online (text, or base64 for binary) and get a short link. Status "checking"/"publishing" means not live yet (poll get_link before sharing); "unpublished" means publishing needs a plan (checkout_url).

post/files

Request

  • Base URL: https://putit.online/api/v1
  • URL: https://putit.online/api/v1/files
  • 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

File name including extension, e.g. "report.pdf" or "index.html". The extension decides how the link renders.

contentstring required

File content: plain text, or base64 when encoding is "base64" (use base64 for any binary file).

encoding'text' | 'base64'

How content is encoded.

mime_typestring

Optional MIME type; used to add a missing file extension.

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

slugstring required
urlstring required

The public link to share.

status'awaiting_upload' | 'checking' | 'live' | 'in_review' | 'unpublished' | 'publishing' | 'removed' | 'expired' | 'deleted' required

checking = not live yet (poll get_link); live = shareable; unpublished = not published; publishing = will be live soon (poll get_link); in_review = not available right now; removed = removed by moderation (see removed_reason, appeal_url).

status_messagestring required
content_urlstring

Only when live, for sites and single files: where the content itself is served (https://<slug>.putitcdn.com/…). Share url instead; it always works.

checkout_urlstring

Only with status unpublished: the page where the uploader can publish this link.

removed_reasonstring

Only with status removed: why, in plain words.

removed_categorystring nullable

Only with status removed: the moderation category (malware, phishing, explicit, …); null when not disclosed.

appeal_urlstring

Only with status removed: mailto link to appeal to abuse@putit.online.

kindstring required

html | site | file | bundle | pending

titlestring required
size_bytesnumber required
file_countnumber required
viewsnumber nullable required

View count; null when the link's account plan has no view counts, or the link has no account.

permanentboolean required
password_protectedboolean required
created_atstring required
expires_atstring nullable required

ISO time the link stops working; null for permanent links.

manage_urlstring

Private page to manage/delete the link. Only returned on creation; keep it secret.

manage_tokenstring

Secret token returned on creation for every new link (keep it secret). Anonymous callers pass it to get_link/delete_link; a link in an account is managed by that account instead.

Changes

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