Skip to content

Does Tickr have a public API?

Yes — under /api/v1/..., authenticated by API key. Full documentation is published at /en/api/.

The public API covers:

  • Time entries: read, create, edit, delete and bulk upsert.
  • Timers: start, stop, list running timers.
  • Projects, tasks, tags and clients: read-only.
  • Cursor pagination (entries, clients), RFC 7807 errors, per-key rate limiting.

To get started:

  1. Create an API key from Integrations → API keys → Create key (illustrated walkthrough: Personal API keys). Every active workspace member can create their own keys:

    • Key role: at most your own role, never Owner. For the MCP connector, pick Workspace User (recommended). An Analyst can only create Analyst (read-only) keys, and a Workspace User cannot create Analyst keys.
    • Expiry: 30 days, 90 days (default), 1 year or never.
    • Shown once: the key is only displayed when it is created. Copy it right away; nobody can display it again.
    • Limits: 10 active keys per workspace and per person; 10 creation attempts per hour (rejected requests count too).
    • An email notifies you every time a key is created on your account (it never contains the key), when email is configured.
    • Owners and Admins can see and revoke every key in their workspace; other members only see their own.
    • Your keys for a workspace are revoked if you leave it, are removed from it, or it is deleted.
    • After a password reset through the emailed link, all sessions and all your API keys, in every workspace, stop working immediately: sign in again, then create new keys. Changing your password from your Profile revokes nothing.
  2. Try it:

    Fenêtre de terminal
    curl https://tickr.coderise.cloud/api/v1/projects \
    -H "Authorization: Bearer tkr_live_<random>"
  3. Browse the endpoint reference for the full list.