API reference / Analytics
Make a short link or a pixel
Makes a short link to a page of the site (https, on its domain or one of its other domains), or a pixel. A link never sends people to another site. A site has 200 at most.
post
/api/v1/analytics/linksOther ways to call it
CLI
troopy analytics links createMCP toolNone. Call it over REST or with the CLI.
Rate limit30 calls in 60 seconds, for each key
RetriesSend an
Idempotency-Key header. A retry with the same key gets the first answer back, and the operation runs one time.Body
application/jsonkind*enum<string>linkpixel
name*stringWhat it is for, such as Launch post on X
At least 1 characters · At most 80 characters
urlstringLinks only: the page of the site to send to
At most 2000 characters · uri
Response
201 · application/jsondata*object8 properties
id*stringA 24-character id
kind*enum<string>linkpixel
name*stringurl*string | nullLinks only: the page of the site
short*stringThe address to share: the link, or the image of the pixel
hits*integerClicks or opens in the period
visitors*integerPeople in the period, each one time a day
createdAt*stringISO 8601 date and time
Errors
400 invalid_inputFix the field named in detail. Each operation's schema is in /api/v1/openapi.json.
401 unauthorizedSend an API key as `Authorization: Bearer tr_live_...`. Create one in Troopy under Settings.
403 forbiddenThe key lacks a scope this operation needs, or its owner lacks the role. detail says which; create a key with the scope, or ask an organization owner or admin.
409 conflictThis Idempotency-Key was used for a different request, or that request is still running. Use a new key for a new request.
429 rate_limitedWait the number of seconds in Retry-After, then retry.