Skip to content
TasksMate Developers

0.x — pre-release, no compatibility promise yet.What this means

TasksMate Developers

Build on TasksMate

The TasksMate API — tasks, projects, teams and webhooks over HTTPS, with a Python SDK and the tm command line.

⌘K to search · ? for shortcuts

Create one
curl -X POST "$TASKSMATE_API_URL/v1/tasks" \
  -H "Authorization: Bearer $TASKSMATE_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"org_id": "O0020", "title": "My first API task"}'

With TasksMate’s public API, your code can read and update everything your team works on:

  • Tasks: the individual pieces of work, each with a status, an assignee and dates.
  • Projects: where tasks live, each with its own members, sections and goals.
  • Sprints: a team’s time-boxed work periods and the tasks planned for each.
  • Milestones: a team’s key checkpoints and the tasks that lead to them.
  • Goals: named groups of a project’s tasks, working toward one outcome.

Two ways to talk to it:

  • API calls: your code asks for data or makes a change, and TasksMate answers straight away. All you need to start.
  • Webhooks (optional): TasksMate tells your app when something changes, so your code doesn’t have to keep asking.
Your codecurl · SDK · tmAccess tokentm_live_…TasksMate/v1Webhookssigned POSTYour appsendscallsresponds with JSONon changedeliversoptional
How it fits together
  • 165 operations over /v1, JSON in and out, one error shape (application/problem+json).
  • Access tokens bound to one organization, with scopes you choose.
  • 99 webhook events, signed with the Standard Webhooks scheme.
  • A typed Python SDK and the tm command line, generated from the same contract as this site.
  • curlevery sample
  • Pythonthe SDK, 3.10+
  • tmthe command line
  • Streamlitan example app
  • Any HTTP clientJSON over HTTPS

The contract is dated 2026-09-25. Everything here is generated from it or written around it — if the two ever disagree, the reference is right.