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/v1

Conventions

  • 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 the nextCursor of one page as cursor to get the next; it is null on the last page.
  • Updates (PATCH) change only the fields you send; where a field accepts null, null clears 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

On this page