API Reference
Every endpoint of the tinbo REST API.
The REST API manages the links, tags, folders and custom domains of one workspace and reads their click analytics.
https://api.tinbo.co/v1Conventions
- Authentication. Every request sends an API key:
Authorization: Bearer tinbo_…. See Authentication. - JSON. Request bodies are JSON (
Content-Type: application/json); so are all responses, errors included. See Errors. - Times are ISO 8601 in UTC:
2026-10-13T09:30:00.000Z. - Lists come as
{ "data": [...] }. Links are paged: pass thenextCursorof one page ascursorto get the next; it isnullon the last page. - Updates (
PATCH) change only the fields you send; where a field acceptsnull,nullclears it. - Rate limit. 300 requests per minute per workspace. See Rate limits.
The OpenAPI document behind this reference is at https://api.tinbo.co/openapi/json, for client generators and API tools.
Resources
Links
Create, find, update and delete short links.
Tags
Label links; a link can carry several.
Folders
Group links; a link lives in one folder at most.
Domains
Bring your own domains and decide where their root and unknown slugs go.
Analytics
Clicks over time and broken down by country, device, referrer and more.