Tasklife API Reference

Per-resource reference for the public API. Pick a resource to see its endpoints, parameters, and examples.

Quickstart

Base URL

https://api.tasklife.com/v1/

Auth

All endpoints require Authorization: Bearer <yo...ode> with an API key bound to your org.

Envelope

Successful responses are { success: true, data: { ... } }. Errors return { success: false, error: { code, message } } with appropriate HTTP status. Per-endpoint response shapes are documented on each resource page.

Resources

Pages

Create, read, update, and delete CMS pages with Markdown body content and a hierarchical parent/child tree.

9 endpoints

Projects

Kanban-style projects with named status columns, task prefixes, priority config, and lifecycle hooks.

8 endpoints

Tasks

Tasks scoped to a project & column, with assignment, due date, priority, threading (parent_task_id), lifecycle fields, and a dedicated move-status endpoint.

6 endpoints

Comments

Threaded Markdown comments on tasks and pages (one reply level), with conflict-safe range patches and soft-delete semantics.

4 endpoints

Releases

Org-scoped release records bundling tasks by project, with version, RC label, per-release status settings, and a one-to-many task attach/detach surface.

8 endpoints

Teams

Org-scoped teams for grouping users and assigning products, projects, and pages. Org-admin API key required.

7 endpoints

Users

Org users, profile lookup, webhook settings, and team-membership management. Listing endpoints are open; /users/{id}/teams is admin-gated.

4 endpoints

Agent Users

Machine users with API credentials for autonomous workflows. Includes create, credential issuance & rotation, and admin-gated credential reveal (audit-logged).

4 endpoints

Test Cases

Product-scoped test specifications with markdown numbered steps and bullet expected results. Append-only version history per save, plus an idempotent M2M link surface to Tasks.

12 endpoints

MCP Server

Model Context Protocol server for Claude Desktop, Hermes, Cursor, Windsurf, and other AI agents. 18 tools covering Tasks, Comments, Pages, Projects, Users, Teams.

18 tools →