Reference

API reference

A public TimerOS API is on our roadmap — Stage 01, in progress — and not yet released. We want to be straight with you: there is no developer-facing REST API, no personal access tokens, and no documented endpoints you can build against today. This page exists so you know where things stand, what has shipped instead, and how to get early access.

On the website dashboard, the Settings → API & webhooks section is a “Coming soon” placeholder — the desktop and web apps have no such section. Nothing on that screen is wired to a backend yet; treat it as a preview of intent, not a working feature.

What has shipped: the AI assistant connector

The first and only shipped integration is the AI assistant connector — a hosted MCP server at https://api.timeros.ai/mcp that lets an assistant such as Claude act as you, within your own permissions, after you sign in and approve a read or read-and-write scope, plus an optional tick box for your incidents and change requests. Its OAuth server exists to sign assistants in on your behalf; it is not a general developer API — the tokens it issues work only at the MCP endpoint, so there is no token for the REST API and nothing a script can call outside an MCP client — and it does not support dynamic client registration.

What is planned

  • Personal access tokens — authenticate programmatic requests against your workspace data.
  • Outbound webhooks — receive events (with delivery health) so timer and project activity can flow into your own toolchain.
  • Integrations — first-party connections to tools like Slack, Google Calendar, Linear, Zapier, and QuickBooks are also planned.
Not available yet
None of the items above is built yet — there is no API-management UI today, and the connector described above is the only working integration. Please do not design against placeholder copy — interfaces will change before release.

How to get early access

If you have an integration use case, we would like to hear it — early input shapes what we build first. Email support@timeros.ai with what you are trying to connect and how.

  1. 1Email us a short description of your integration goal.
  2. 2Watch the roadmap for API and integration milestones.
  3. 3Check the changelog once endpoints ship — that is where docs will land.

For everything available today, see the product overview. Need help in the meantime? Visit Help & support.