Links
Change a short link
PATCH
A new destination applies at once. enabled: false stops the redirect until turned on again. The code cannot change. A link Tebar blocked cannot be changed (403 link_blocked).
Requires the write scope.
bearerheader
AuthorizationBearer <token>An API key (tb_live_...) from the dashboard, or an OAuth access token.
id*stringFormat
uuidTebar-Profile?stringLimits an owner key to one profile (id or external_id). Unknown: 404 profile_not_found.
application/json- body
url?stringFormat
uriLength
length <= 2048title?|nullenabled?booleanThe link.
application/json- response
id*stringFormat
uuidprofile_id*stringFormat
uuidcode*stringThe part after tbr.ink/: 6 random characters, or the alias (Pro and Agency).
short_url*stringThe link to share, e.g. https://tbr.ink/aB3x9K.
url*stringWhere the link leads; can be changed.
title*string|nullstatus*stringblocked: by Tebar for breaking the rules.
Value in
"active""disabled""blocked"clicks*integerOnce per visitor per link per hour; bots left out.
unique_visitors*integerEach day's distinct visitors, added up.
bot_visits*integerLink previews and crawlers, not counted as clicks.
last_clicked_at*|nullcreated_at*stringFormat
date-timeupdated_at*stringFormat
date-timecurl -X PATCH 'https://api.tebar.app/v1/links/497f6eca-6276-4993-bfeb-53cbbbba6f08' \
-H 'Content-Type: application/json' \
-d '{}'Example Response
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"profile_id": "bfcb6779-b1f9-41fc-92d7-88f8bc1d12e8",
"code": "string",
"short_url": "string",
"url": "string",
"title": "string",
"status": "active",
"clicks": 0,
"unique_visitors": 0,
"bot_visits": 0,
"last_clicked_at": "2019-08-24T14:15:22Z",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
}