Get link status
get_linkRead-onlyIdempotent
Status of a link: live, checking, publishing, unpublished, in_review, removed (by moderation: removed_reason + appeal_url), expired or awaiting_upload; plus expiry, size and views (null when the account’s plan has no view counts). Anonymous callers pass the manage_token they got on creation.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| slug | Yes | The link name, e.g. "k3x9pq" (a full https://putit.online/<name> URL also works). | |
| manage_token | No | Secret manage token returned when the link was created (lets anonymous callers manage it). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | The public link to share. | |
| kind | Yes | html | site | file | bundle | pending | |
| slug | Yes | ||
| title | Yes | ||
| views | Yes | View count; null when the link's account plan has no view counts, or the link has no account. | |
| status | Yes | 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). | |
| permanent | Yes | ||
| appeal_url | No | Only with status removed: mailto link to appeal to abuse@putit.online. | |
| created_at | Yes | ||
| expires_at | Yes | ISO time the link stops working; null for permanent links. | |
| file_count | Yes | ||
| manage_url | No | Private page to manage/delete the link. Only returned on creation; keep it secret. | |
| size_bytes | Yes | ||
| checkout_url | No | Only with status unpublished: the page where the uploader can publish this link. | |
| manage_token | No | Secret token for get_link/delete_link without an account. Only returned on creation. | |
| removed_reason | No | Only with status removed: why, in plain words. | |
| status_message | Yes | ||
| removed_category | No | Only with status removed: the moderation category (malware, phishing, explicit, …); null when not disclosed. | |
| password_protected | Yes |