REST API

Mon, 01 Jan 0001 00:00:00 +0000

REST API reference for Timill Platform including all endpoints and request/response formats.

Base URL#

https://your-domain.com/api/v1

Authentication#

All endpoints require JWT authentication except public endpoints:

Authorization: Bearer <token>

Endpoints#

Instance-admin endpoints (/api/v1/admin/...) — listing every group on the instance and managing manual Plus subscriptions — live on a separate, scope-gated surface, documented for instance admins inside your own instance at /docs/api-reference/admin-rest-api/.

MCP Server

Mon, 01 Jan 0001 00:00:00 +0000

Timill ships a Model Context Protocol server bundled inside the platform itself, so AI agents (Claude, and any MCP-capable host) can read and write your Timill data the same way the REST API does — e.g. “Create a goal and a few tasks for John, blocked by the Q2 launch.”

It is served over Streamable HTTP at the path /mcp on your instance, and exposes a small set of generic tools (no hardcoded item types — they adapt to your group’s schema). Every call is authenticated per-user and enforced by the same RBAC that governs the rest of the app: an agent can only ever see and do what the authenticating user can.

API Reference on Timill Platform Documentation

REST API

Base URL#

Authentication#

Endpoints#

MCP Server