kanban-todo-tasks-projects-board

Report this endpoint's licence state for your token as JSON: the product, the tier free or pro, why it is not Pro, and the checkout URL. Call it to explain a free-tier refusal. No arguments, nothing changes.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Turn Pro on for this connection with key, an MCPL1.<payload>.<signature> issued at checkout for this server or the bundle. Data under your token stays; a wrong or expired key changes nothing. license_status confirms it.

{
  "type": "object",
  "properties": {
    "key": {
      "type": "string",
      "description": "License key from checkout, MCPL1.<payload>.<signature>"
    }
  },
  "required": [
    "key"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Add one task to a board and return its id, board and column. The board is created on first use, so pass an existing project or leave it out. An identical open task is refused. Free: 3 boards, 200 open.

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "maxLength": 300,
      "description": "What the task is, e.g. 'Write the launch email'"
    },
    "project": {
      "type": "string",
      "maxLength": 100,
      "description": "Project or board name. A partial name matching exactly one existing project is used as that project. Defaults to your only board."
    },
    "column": {
      "type": "string",
      "maxLength": 40,
      "description": "Column to start in; defaults to the first column (backlog)"
    },
    "due": {
      "type": "string",
      "maxLength": 64,
      "description": "Due date: YYYY-MM-DD, 'today', 'tomorrow', 'Friday', 'next Monday' or '+3d'"
    },
    "estimate_minutes": {
      "type": "integer",
      "minimum": 0,
      "maximum": 100000,
      "description": "How long you think it will take, in minutes"
    },
    "priority": {
      "type": "string",
      "enum": [
        "low",
        "normal",
        "high",
        "urgent"
      ],
      "description": "Priority; defaults to normal"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 60
      },
      "maxItems": 30,
      "description": "Free-form tags, e.g. ['writing','client']"
    },
    "notes": {
      "type": "string",
      "maxLength": 5000,
      "description": "Longer notes for the task"
    }
  },
  "required": [
    "title"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List tasks as a table of id, project, column, title, priority, due, estimate, actual and tags, sorted by due date, with the total estimate. Done tasks are left out unless include_done. 200 rows default.

{
  "type": "object",
  "properties": {
    "project": {
      "type": "string",
      "maxLength": 100,
      "description": "Only this project"
    },
    "column": {
      "type": "string",
      "maxLength": 40,
      "description": "Only this column, e.g. 'doing'"
    },
    "tag": {
      "type": "string",
      "maxLength": 60,
      "description": "Only tasks carrying this tag"
    },
    "due_before": {
      "type": "string",
      "maxLength": 64,
      "description": "Only tasks due on or before this day (YYYY-MM-DD, 'today', 'Friday', '+7d')"
    },
    "overdue": {
      "type": "boolean",
      "description": "Only tasks past their due date"
    },
    "include_done": {
      "type": "boolean",
      "description": "Include finished tasks; default false"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 2000,
      "description": "Rows to print; default 200"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Move one task to another column of its own board and report the old and new column. An unknown column is refused, listing the real ones. Entering the done column stamps completion; leaving it clears it.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 64,
      "description": "Task id, e.g. NOVA-12"
    },
    "column": {
      "type": "string",
      "maxLength": 40,
      "description": "Target column, e.g. 'doing'"
    }
  },
  "required": [
    "id",
    "column"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Change a task by id: only the fields you pass are touched. tags REPLACES the whole list, due 'none' clears it, and project moves the task to a board that already exists. Returns the task's new row.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 64,
      "description": "Task id, e.g. NOVA-12"
    },
    "title": {
      "type": "string",
      "maxLength": 300
    },
    "notes": {
      "type": "string",
      "maxLength": 5000
    },
    "due": {
      "type": "string",
      "maxLength": 64,
      "description": "New due date, or 'none' to clear it"
    },
    "estimate_minutes": {
      "type": "integer",
      "minimum": 0,
      "maximum": 100000
    },
    "priority": {
      "type": "string",
      "enum": [
        "low",
        "normal",
        "high",
        "urgent"
      ]
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 60
      },
      "maxItems": 30,
      "description": "Replaces the whole tag list"
    },
    "column": {
      "type": "string",
      "maxLength": 40
    },
    "project": {
      "type": "string",
      "maxLength": 100,
      "description": "Move the task to another existing project board"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Mark one task finished: it moves to the board's done column (named done, else the last) and is stamped, leaving task_list and the open counts. Returns estimate against actual when both are known.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 64,
      "description": "Task id, e.g. NOVA-12"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Delete one task by id, permanently; the id is never reused. The answer names any logged minutes lost. time-tracker entries are a separate store and are untouched. Use task_done to keep the record.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 64,
      "description": "Task id, e.g. NOVA-12"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Find tasks whose id, title, notes or tags contain the query, across every board, finished ones included. Plain case-insensitive substring, never a regex. Use task_list for structured filters.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 200,
      "description": "Text to look for"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 2000,
      "description": "Rows to print; default 200"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Show one board column by column: tasks, estimate, actual and overdue count in each, then the board totals and the estimate still open. Defaults to your busiest board. Use project_list for every board.

{
  "type": "object",
  "properties": {
    "project": {
      "type": "string",
      "maxLength": 100,
      "description": "Which board; defaults to your busiest one"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Return the exact arguments to pass to the time-tracker's timer_start for one task, and record the link here. It starts nothing itself, and warns when the tracker's own project names would misfile the time.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 64,
      "description": "Task id, e.g. NOVA-12"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Add real minutes worked to one task so estimate and actual can be compared. Minutes ADD; a negative corrects an over-count. Below zero or past 100,000 is refused. This counter is the board's own.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 64,
      "description": "Task id, e.g. NOVA-12"
    },
    "minutes": {
      "type": "integer",
      "minimum": -100000,
      "maximum": 100000,
      "description": "Minutes to add; a negative number corrects an over-count"
    }
  },
  "required": [
    "id",
    "minutes"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List every board with its task-id prefix, open and done counts, estimate still open and overdue count, plus free-tier use (3 boards, 200 open tasks). Use board for one board broken down by column.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Delete an empty board and give its free-tier slot back. A board still holding tasks, open or done, is refused with one named, because task_add creates boards as a side effect and the work would be lost.

{
  "type": "object",
  "properties": {
    "project": {
      "type": "string",
      "maxLength": 100,
      "description": "Board to remove, e.g. 'Nova Site'. It must hold no tasks at all."
    }
  },
  "required": [
    "project"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List every task whose due day is already past, across all boards, oldest first, in the task_list table. as_of measures against a day you name. A finished task, or one with no due date, never counts.

{
  "type": "object",
  "properties": {
    "as_of": {
      "type": "string",
      "maxLength": 64,
      "description": "Measure against this day instead of today (YYYY-MM-DD, 'next Monday', '+7d')"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 2000,
      "description": "Rows to print; default 200"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Compare done against planned for one ISO week per project: how many were due, how many of those are finished, how many were completed, and estimate against actual minutes. Any week but this one is Pro.

{
  "type": "object",
  "properties": {
    "week": {
      "type": "string",
      "maxLength": 16,
      "description": "ISO week, e.g. '2026-W36'. Defaults to this week. Past weeks are a Pro feature."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Replace one board's columns, in order, with 2 to 12 unique names. Tasks in a removed column move to the FIRST column. Blanks are dropped first, so a list normalising below two names is refused. Pro.

{
  "type": "object",
  "properties": {
    "project": {
      "type": "string",
      "maxLength": 100,
      "description": "Which board"
    },
    "columns": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 40
      },
      "minItems": 2,
      "maxItems": 12,
      "description": "The new column names in order, at most 12, e.g. ['inbox','next','doing','done']"
    }
  },
  "required": [
    "project",
    "columns"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}