Raw schema
{
"type": "object",
"properties": {
"link": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"description": "The short link (https://snip.link/abc123), its ending (abc123) or its id."
},
"ending": {
"type": "string",
"minLength": 3,
"maxLength": 40,
"description": "The new ending: 3 to 40 ASCII letters, digits, dashes or underscores, with no spaces. Reusing this link's previous ending or changing only its case does not use another previous-ending slot."
},
"url": {
"type": "string",
"minLength": 1,
"maxLength": 2048,
"description": "The new http or https destination."
},
"title": {
"type": "string",
"maxLength": 200,
"description": "A new name for the dashboard."
},
"disabled": {
"type": "boolean",
"description": "True switches the link off (it answers 404); false switches it back on."
},
"routes": {
"type": "array",
"maxItems": 20,
"description": "Rules that send some visits elsewhere, tried in order; the first match wins and everyone else goes to url. Free with a Snip account. Each rule: conditions joined by when (all or any) and its own url. Condition kinds: device (values mobile, tablet, desktop), os (ios, android, windows, macos, linux, chromeos), browser (chrome, safari, firefox, edge, samsung, opera, instagram, facebook, tiktok), country (ISO codes like US), region (US-CA), language (en, es), time (from and to as HH:MM, tz an IANA zone or \"visitor\"), weekday (values 0 Sunday to 6, tz), dates (from and/or to as 2026-11-01 or 2026-11-01T09:00, tz), via (value qr or link), referrer (sites like instagram.com), query (param, optional value), split (percent 1 to 99; neighbouring splits share visitors, so 50 then 50 is an A/B test). Any condition but split takes negate true. A rule with action off and no url switches the link off for matching visits instead (a time window, a country): they see a \"not available right now\" page and are not counted. An empty list removes every rule.",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"maxLength": 60,
"description": "A label for the dashboard."
},
"when": {
"type": "string",
"enum": [
"all",
"any"
],
"description": "all (default): every condition. any: one is enough."
},
"conditions": {
"type": "array",
"minItems": 1,
"maxItems": 10,
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"device",
"os",
"browser",
"country",
"region",
"language",
"time",
"weekday",
"dates",
"via",
"referrer",
"query",
"split"
]
},
"values": {
"type": "array",
"items": {
"type": [
"string",
"number"
]
}
},
"from": {
"type": "string"
},
"to": {
"type": "string"
},
"tz": {
"type": "string"
},
"value": {
"type": [
"string",
"null"
]
},
"param": {
"type": "string"
},
"percent": {
"type": "integer",
"description": "split: a whole percent from 1 to 99."
},
"negate": {
"type": "boolean"
}
},
"required": [
"kind"
],
"additionalProperties": false
}
},
"url": {
"type": "string",
"description": "Where a matching visit goes. Leave out when action is off."
},
"action": {
"type": "string",
"enum": [
"redirect",
"off"
],
"description": "redirect (default): send the visit to url. off: switch the link off for it."
}
},
"required": [
"conditions"
],
"additionalProperties": false
}
},
"starts_at": {
"type": [
"string",
"null"
],
"description": "When the link goes live, as an ISO date and time (2026-11-01T09:00:00Z). Before it, visits see a not live yet page and are not counted. null: live now."
},
"expires_at": {
"type": [
"string",
"null"
],
"description": "When the link stops working, as an ISO date and time. After it, visits see an expired page. null: never."
},
"max_clicks": {
"type": [
"integer",
"null"
],
"minimum": 1,
"description": "Stop the link after this many counted visits in total (bots and repeat taps within a minute are not counted). null: no limit."
},
"track": {
"type": "boolean",
"description": "false: only count visits, without recording when, where or on what device. true: record them."
},
"preview": {
"type": [
"object",
"null"
],
"description": "The link's own preview card for chats and posts. Any field left out shows the page's own. image is an https picture address or screenshot (the page's first screen). null removes it. Free on every plan.",
"properties": {
"title": {
"type": "string",
"maxLength": 120
},
"description": {
"type": "string",
"maxLength": 300
},
"image": {
"type": "string",
"maxLength": 2048
}
},
"additionalProperties": false
},
"watch": {
"type": "string",
"enum": [
"daily",
"weekly",
"off"
],
"description": "Watch the destination page: Snip saves a fresh copy daily or weekly and emails the user what was added and what went when its words change. off stops. A paid plan feature; the error says which plan has it."
}
},
"required": [
"link"
],
"additionalProperties": false
}