MeisterTask

App · 26 actions

Work with your MeisterTask boards: list, create, update, complete, move and assign tasks and subtasks, manage projects, sections and labels, and read and add comments.

Actions

ActionWhat it does
Add commentComment on a task as the connected person.
Add label to taskPut a label on a task.
Create labelAdd a label to a project.
Create projectCreate a project with a name and optional notes.
Create sectionAdd a section (column) to a project.
Create subtaskCreate a task under another task, in the same section.
Create taskCreate a task in a section, or in a project's first section, with an optional description, assignee, due date and labels.
Delete commentDelete a comment.
Delete labelDelete a label from its project, which takes it off every task that has it.
Get current userGet the MeisterTask person the connection acts as: name, email and avatar.
Get projectGet one project with its name, notes and status.
Get taskGet one task with its section, assignee, due date and status.
List commentsList the comments on a task, with who wrote them and when.
List labelsList a project's labels (called tags in MeisterTask) with their colors.
List peopleList the people you share projects with, or the people who have access to one project.
List project tasksList the tasks of one project, or of one of its sections.
List projectsList your projects, active ones unless you choose archived or all.
List sectionsList a project's sections (the columns tasks sit in), in board order.
List subtasksList the tasks under a task.
List task labelsList the labels on a task.
List tasksList tasks from every project you can see, filtered by status or to your own.
Remove label from taskTake a label off a task.
Update labelRename a label or change its color.
Update projectRename a project, change its description, or archive, trash or restore it.
Update sectionRename a section, or trash or restore it.
Update taskChange a task: rename it, reassign it, set a due date, move it to another section, or complete, reopen, archive or trash it.

Add comment

Comment on a task as the connected person. Markdown works.

Inputs

Task IDtask_idtextRequired
The task's id, from 'List tasks' or an earlier step.
CommenttexttextRequired
What to say.

Outputs

commentobject
The comment
Example output
{
  "comment": {
    "created_at": "2026-04-02T03:14:15.926535Z",
    "id": 2,
    "person_id": 8,
    "task_id": 15,
    "text": "Looks awesome!",
    "text_html": "<p>Looks awesome!</p>\n",
    "updated_at": "2026-04-02T03:14:15.926535Z"
  }
}

Add label to task

Put a label on a task. The label must belong to the task's project.

Inputs

Projectproject_idtext
The project, to load its choices below. Not needed when you give the id from an earlier step.
Task IDtask_idtextRequired
The task's id, from 'List tasks' or an earlier step.
Labellabel_idtextRequired
The label (tag). Pick a project first to load its labels.

Outputs

task_idnumber
The task
task_labelobject
The link between task and label
Example output
{
  "task_id": 15,
  "task_label": {
    "id": 364,
    "label_id": 25,
    "task_id": 15
  }
}

Create label

Add a label to a project. Names are unique within a project, ignoring case.

Inputs

Projectproject_idtextRequired
The project. Pick one, or give its id from an earlier step.
NamenametextRequired
The label's name.
Colorcolortext
The label's color. Defaults to red.One of: d93651 (Red (default)), ff9f1a (Orange), ffd500 (Yellow), 8acc47 (Grass green), 47cc8a (Moss green), 30bfbf (Turquoise), 00aaff (Blue), 8f7ee6 (Purple), 98aab3 (Grey).

Outputs

labelobject
The label
Example output
{
  "label": {
    "color": "47cc8a",
    "id": 25,
    "name": "Feature",
    "project_id": 123
  }
}

Create project

Create a project with a name and optional notes.

Inputs

NamenametextRequired
The project's name.
Descriptionnotestext
What the project is for.

Outputs

projectobject
The project
Example output
{
  "project": {
    "created_at": "2026-01-13T09:29:36.360375Z",
    "id": 123,
    "name": "Getting Started",
    "notes": "A demo project",
    "status": 1,
    "token": "s3i5reaF",
    "updated_at": "2026-01-16T10:10:21.460697Z"
  }
}

Create section

Add a section (column) to a project.

Inputs

Projectproject_idtextRequired
The project. Pick one, or give its id from an earlier step.
NamenametextRequired
The section's name.

Outputs

sectionobject
The section
Example output
{
  "section": {
    "color": "30bfbf",
    "created_at": "2026-01-13T09:29:36.722740Z",
    "description": "Work in progress",
    "id": 73,
    "indicator": 24,
    "name": "Open",
    "project_id": 123,
    "sequence": 1,
    "status": 1,
    "updated_at": "2026-01-13T09:29:36.722616Z"
  }
}

Create subtask

Create a task under another task, in the same section.

Inputs

Parent task IDtask_idtextRequired
The task to add the subtask under, from 'List tasks' or an earlier step.
NamenametextRequired
The subtask's title.
Descriptionnotestext
The subtask's description. Markdown works.
Assigneeassigned_to_idtext
The person the task is assigned to.
Dueduedate and time
When the task is due.

Outputs

taskobject
The task
Example output
{
  "task": {
    "assigned_to_id": 8,
    "created_at": "2026-02-06T17:01:33.635649Z",
    "due": "2026-11-20T17:00:00Z",
    "id": 16,
    "name": "Draft the email",
    "notes": "Before Friday",
    "project_id": 123,
    "section_id": 73,
    "section_name": "Open",
    "sequence": 100,
    "status": 1,
    "status_updated_at": "2026-05-09T14:49:18.303930Z",
    "token": "gvuUs17f",
    "tracked_time": 0,
    "updated_at": "2026-05-09T14:49:18.304227Z"
  }
}

Create task

Create a task in a section, or in a project's first section, with an optional description, assignee, due date and labels.

Inputs

Projectproject_idtext
The project to add the task to. With no section, the task goes in the project's first section.
Sectionsection_idtext
The section (column). Pick a project first to load its sections.
NamenametextRequired
The task's title.
Descriptionnotestext
The task's description. Markdown works.
Assigneeassigned_to_idtext
The person the task is assigned to.
Dueduedate and time
When the task is due.
Labelslabel_idslist
Labels to put on the task. Pick a project first to load its labels.

Outputs

taskobject
The task
Example output
{
  "task": {
    "assigned_to_id": 8,
    "created_at": "2026-02-06T17:01:33.635649Z",
    "due": "2026-11-20T17:00:00Z",
    "id": 15,
    "name": "Send the invoice",
    "notes": "Before Friday",
    "project_id": 123,
    "section_id": 73,
    "section_name": "Open",
    "sequence": 100,
    "status": 1,
    "status_updated_at": "2026-05-09T14:49:18.303930Z",
    "token": "gvuUs17f",
    "tracked_time": 0,
    "updated_at": "2026-05-09T14:49:18.304227Z"
  }
}

Delete comment

Delete a comment. MeisterTask lets people delete only their own.

Inputs

Comment IDcomment_idtextRequired
The comment's id, from 'List comments' or 'Add comment'.

Outputs

comment_idnumber
The comment deleted
deletedtrue/false
Always true once deleted
Example output
{
  "comment_id": 2,
  "deleted": true
}

Delete label

Delete a label from its project, which takes it off every task that has it.

Inputs

Projectproject_idtext
The project, to load its choices below. Not needed when you give the id from an earlier step.
Labellabel_idtextRequired
The label (tag). Pick a project first to load its labels.

Outputs

deletedtrue/false
Always true once deleted
label_idnumber
The label deleted
Example output
{
  "deleted": true,
  "label_id": 25
}

Get current user

Get the MeisterTask person the connection acts as: name, email and avatar.

Inputs

None.

Outputs

personobject
The person
Example output
{
  "person": {
    "avatar": "https://www.example.com/avatars/jane.jpg",
    "avatar_thumb": "https://www.example.com/avatars/jane-thumb.jpg",
    "created_at": "2026-01-13T09:29:36.360375Z",
    "email": "jane@example.com",
    "firstname": "Jane",
    "id": 8,
    "lastname": "Demo",
    "updated_at": "2026-01-16T10:10:21.460697Z"
  }
}

Get project

Get one project with its name, notes and status.

Inputs

Projectproject_idtextRequired
The project. Pick one, or give its id from an earlier step.

Outputs

projectobject
The project
Example output
{
  "project": {
    "created_at": "2026-01-13T09:29:36.360375Z",
    "id": 123,
    "name": "Getting Started",
    "notes": "A demo project",
    "status": 1,
    "token": "s3i5reaF",
    "updated_at": "2026-01-16T10:10:21.460697Z"
  }
}

Get task

Get one task with its section, assignee, due date and status.

Inputs

Task IDtask_idtextRequired
The task's id, from 'List tasks' or an earlier step.

Outputs

taskobject
The task
Example output
{
  "task": {
    "assigned_to_id": 8,
    "created_at": "2026-02-06T17:01:33.635649Z",
    "due": "2026-11-20T17:00:00Z",
    "id": 15,
    "name": "Send the invoice",
    "notes": "Before Friday",
    "project_id": 123,
    "section_id": 73,
    "section_name": "Open",
    "sequence": 100,
    "status": 1,
    "status_updated_at": "2026-05-09T14:49:18.303930Z",
    "token": "gvuUs17f",
    "tracked_time": 0,
    "updated_at": "2026-05-09T14:49:18.304227Z"
  }
}

List comments

List the comments on a task, with who wrote them and when.

Inputs

Task IDtask_idtextRequired
The task's id, from 'List tasks' or an earlier step.
Page sizelimitnumber
How many to return, 1 to 500. MeisterTask's default is 50.From 1 to 500.
Pagepagenumber
Which page to return, starting at 1. Use 'Next page' from the last run.At least 1.

Outputs

commentslist
The comments
countnumber
How many on this page
has_moretrue/false
True when another page follows this one
next_pagenumber
Pass as 'page' for the next page; 0 on the last one
pagenumber
The page number returned
Example output
{
  "comments": [
    {
      "created_at": "2026-04-02T03:14:15.926535Z",
      "id": 2,
      "person_id": 8,
      "task_id": 15,
      "text": "Looks awesome!",
      "text_html": "<p>Looks awesome!</p>\n",
      "updated_at": "2026-04-02T03:14:15.926535Z"
    }
  ],
  "count": 1,
  "has_more": false,
  "next_page": 0,
  "page": 1
}

List labels

List a project's labels (called tags in MeisterTask) with their colors.

Inputs

Projectproject_idtextRequired
The project. Pick one, or give its id from an earlier step.

Outputs

countnumber
How many
labelslist
The labels
Example output
{
  "count": 1,
  "labels": [
    {
      "color": "47cc8a",
      "id": 25,
      "name": "Feature",
      "project_id": 123
    }
  ]
}

List people

List the people you share projects with, or the people who have access to one project. Their ids are what 'Assignee' takes.

Inputs

Projectproject_idtext
Only people with access to this project. Leave empty for everyone.

Outputs

countnumber
How many
personslist
The people
Example output
{
  "count": 1,
  "persons": [
    {
      "avatar": "https://www.example.com/avatars/jane.jpg",
      "avatar_thumb": "https://www.example.com/avatars/jane-thumb.jpg",
      "created_at": "2026-01-13T09:29:36.360375Z",
      "email": "jane@example.com",
      "firstname": "Jane",
      "id": 8,
      "lastname": "Demo",
      "updated_at": "2026-01-16T10:10:21.460697Z"
    }
  ]
}

List project tasks

List the tasks of one project, or of one of its sections. Gets one page; to see more, run it again with the next page.

Inputs

Projectproject_idtextRequired
The project. Pick one, or give its id from an earlier step.
Sectionsection_idtext
Only tasks in this section. Pick a project first to load its sections.
Statusstatustext
Which tasks to include. Defaults to MeisterTask's own default.One of: open, completed, completed_archived (Completed and archived), trashed.
Only my tasksassigned_to_metrue/false
Only tasks assigned to you.Default: false.
Ordersorttext
How to order the tasks. Defaults to oldest first.One of: id (Oldest first (default)), -id (Newest first), -updated_at (Recently changed first), due (Due soonest first).
Page sizelimitnumber
How many to return, 1 to 500. MeisterTask's default is 50.From 1 to 500.
Pagepagenumber
Which page to return, starting at 1. Use 'Next page' from the last run.At least 1.

Outputs

countnumber
How many on this page
has_moretrue/false
True when another page follows this one
next_pagenumber
Pass as 'page' for the next page; 0 on the last one
pagenumber
The page number returned
taskslist
The tasks
Example output
{
  "count": 1,
  "has_more": false,
  "next_page": 0,
  "page": 1,
  "tasks": [
    {
      "assigned_to_id": 8,
      "created_at": "2026-02-06T17:01:33.635649Z",
      "due": "2026-11-20T17:00:00Z",
      "id": 15,
      "name": "Send the invoice",
      "notes": "Before Friday",
      "project_id": 123,
      "section_id": 73,
      "section_name": "Open",
      "sequence": 100,
      "status": 1,
      "status_updated_at": "2026-05-09T14:49:18.303930Z",
      "token": "gvuUs17f",
      "tracked_time": 0,
      "updated_at": "2026-05-09T14:49:18.304227Z"
    }
  ]
}

List projects

List your projects, active ones unless you choose archived or all. Gets one page; to see more, run it again with the next page.

Inputs

Statusstatustext
Which projects to include. Defaults to active.One of: active (Active (default)), archived, all (Active and archived).
Page sizelimitnumber
How many to return, 1 to 500. MeisterTask's default is 50.From 1 to 500.
Pagepagenumber
Which page to return, starting at 1. Use 'Next page' from the last run.At least 1.

Outputs

countnumber
How many on this page
has_moretrue/false
True when another page follows this one
next_pagenumber
Pass as 'page' for the next page; 0 on the last one
pagenumber
The page number returned
projectslist
The projects
Example output
{
  "count": 1,
  "has_more": false,
  "next_page": 0,
  "page": 1,
  "projects": [
    {
      "created_at": "2026-01-13T09:29:36.360375Z",
      "id": 123,
      "name": "Getting Started",
      "notes": "A demo project",
      "status": 1,
      "token": "s3i5reaF",
      "updated_at": "2026-01-16T10:10:21.460697Z"
    }
  ]
}

List sections

List a project's sections (the columns tasks sit in), in board order.

Inputs

Projectproject_idtextRequired
The project. Pick one, or give its id from an earlier step.
Statusstatustext
Which sections to include. Defaults to active.One of: active (Active (default)), trashed, all (Active and trashed).
Page sizelimitnumber
How many to return, 1 to 500. MeisterTask's default is 50.From 1 to 500.
Pagepagenumber
Which page to return, starting at 1. Use 'Next page' from the last run.At least 1.

Outputs

countnumber
How many on this page
has_moretrue/false
True when another page follows this one
next_pagenumber
Pass as 'page' for the next page; 0 on the last one
pagenumber
The page number returned
sectionslist
The sections
Example output
{
  "count": 1,
  "has_more": false,
  "next_page": 0,
  "page": 1,
  "sections": [
    {
      "color": "30bfbf",
      "created_at": "2026-01-13T09:29:36.722740Z",
      "description": "Work in progress",
      "id": 73,
      "indicator": 24,
      "name": "Open",
      "project_id": 123,
      "sequence": 1,
      "status": 1,
      "updated_at": "2026-01-13T09:29:36.722616Z"
    }
  ]
}

List subtasks

List the tasks under a task.

Inputs

Task IDtask_idtextRequired
The task's id, from 'List tasks' or an earlier step.
Page sizelimitnumber
How many to return, 1 to 500. MeisterTask's default is 50.From 1 to 500.
Pagepagenumber
Which page to return, starting at 1. Use 'Next page' from the last run.At least 1.

Outputs

countnumber
How many on this page
has_moretrue/false
True when another page follows this one
next_pagenumber
Pass as 'page' for the next page; 0 on the last one
pagenumber
The page number returned
taskslist
The subtasks
Example output
{
  "count": 1,
  "has_more": false,
  "next_page": 0,
  "page": 1,
  "tasks": [
    {
      "assigned_to_id": 8,
      "created_at": "2026-02-06T17:01:33.635649Z",
      "due": "2026-11-20T17:00:00Z",
      "id": 15,
      "name": "Send the invoice",
      "notes": "Before Friday",
      "project_id": 123,
      "section_id": 73,
      "section_name": "Open",
      "sequence": 100,
      "status": 1,
      "status_updated_at": "2026-05-09T14:49:18.303930Z",
      "token": "gvuUs17f",
      "tracked_time": 0,
      "updated_at": "2026-05-09T14:49:18.304227Z"
    }
  ]
}

List task labels

List the labels on a task.

Inputs

Task IDtask_idtextRequired
The task's id, from 'List tasks' or an earlier step.

Outputs

countnumber
How many
labelslist
The labels on the task
Example output
{
  "count": 1,
  "labels": [
    {
      "color": "47cc8a",
      "id": 25,
      "name": "Feature",
      "project_id": 123
    }
  ]
}

List tasks

List tasks from every project you can see, filtered by status or to your own. Gets one page; to see more, run it again with the next page.

Inputs

Statusstatustext
Which tasks to include. Defaults to MeisterTask's own default.One of: open, completed, completed_archived (Completed and archived), trashed.
Only my tasksassigned_to_metrue/false
Only tasks assigned to you.Default: false.
Ordersorttext
How to order the tasks. Defaults to oldest first.One of: id (Oldest first (default)), -id (Newest first), -updated_at (Recently changed first), due (Due soonest first).
Page sizelimitnumber
How many to return, 1 to 500. MeisterTask's default is 50.From 1 to 500.
Pagepagenumber
Which page to return, starting at 1. Use 'Next page' from the last run.At least 1.

Outputs

countnumber
How many on this page
has_moretrue/false
True when another page follows this one
next_pagenumber
Pass as 'page' for the next page; 0 on the last one
pagenumber
The page number returned
taskslist
The tasks
Example output
{
  "count": 1,
  "has_more": false,
  "next_page": 0,
  "page": 1,
  "tasks": [
    {
      "assigned_to_id": 8,
      "created_at": "2026-02-06T17:01:33.635649Z",
      "due": "2026-11-20T17:00:00Z",
      "id": 15,
      "name": "Send the invoice",
      "notes": "Before Friday",
      "project_id": 123,
      "section_id": 73,
      "section_name": "Open",
      "sequence": 100,
      "status": 1,
      "status_updated_at": "2026-05-09T14:49:18.303930Z",
      "token": "gvuUs17f",
      "tracked_time": 0,
      "updated_at": "2026-05-09T14:49:18.304227Z"
    }
  ]
}

Remove label from task

Take a label off a task. Nothing happens if the task does not have it.

Inputs

Projectproject_idtext
The project, to load its choices below. Not needed when you give the id from an earlier step.
Task IDtask_idtextRequired
The task's id, from 'List tasks' or an earlier step.
Labellabel_idtextRequired
The label (tag). Pick a project first to load its labels.

Outputs

label_idnumber
The label
removedtrue/false
True if the label was on the task and is now off it
task_idnumber
The task
Example output
{
  "label_id": 25,
  "removed": true,
  "task_id": 15
}

Update label

Rename a label or change its color. Empty fields stay as they are.

Inputs

Projectproject_idtext
The project, to load its choices below. Not needed when you give the id from an earlier step.
Labellabel_idtextRequired
The label (tag). Pick a project first to load its labels.
Namenametext
A new name. Leave empty to keep it.
Colorcolortext
A new color. Leave empty to keep it.One of: d93651 (Red (default)), ff9f1a (Orange), ffd500 (Yellow), 8acc47 (Grass green), 47cc8a (Moss green), 30bfbf (Turquoise), 00aaff (Blue), 8f7ee6 (Purple), 98aab3 (Grey).

Outputs

labelobject
The label
Example output
{
  "label": {
    "color": "47cc8a",
    "id": 25,
    "name": "Feature",
    "project_id": 123
  }
}

Update project

Rename a project, change its description, or archive, trash or restore it. Empty fields stay as they are.

Inputs

Projectproject_idtextRequired
The project. Pick one, or give its id from an earlier step.
Namenametext
A new name. Leave empty to keep it.
Descriptionnotestext
A new description. Leave empty to keep it.
Statusstatustext
Archive, trash or restore (Active) the project. Trashed projects can be restored in MeisterTask. Leave empty to keep it.One of: active, archived, trashed.

Outputs

projectobject
The project
Example output
{
  "project": {
    "created_at": "2026-01-13T09:29:36.360375Z",
    "id": 123,
    "name": "Getting Started",
    "notes": "A demo project",
    "status": 1,
    "token": "s3i5reaF",
    "updated_at": "2026-01-16T10:10:21.460697Z"
  }
}

Update section

Rename a section, or trash or restore it. Empty fields stay as they are.

Inputs

Projectproject_idtext
The project, to load its choices below. Not needed when you give the id from an earlier step.
Sectionsection_idtextRequired
The section (column). Pick a project first to load its sections.
Namenametext
A new name. Leave empty to keep it.
Statusstatustext
Trash or restore (Active) the section. Leave empty to keep it.One of: active, trashed.

Outputs

sectionobject
The section
Example output
{
  "section": {
    "color": "30bfbf",
    "created_at": "2026-01-13T09:29:36.722740Z",
    "description": "Work in progress",
    "id": 73,
    "indicator": 24,
    "name": "Open",
    "project_id": 123,
    "sequence": 1,
    "status": 1,
    "updated_at": "2026-01-13T09:29:36.722616Z"
  }
}

Update task

Change a task: rename it, reassign it, set a due date, move it to another section, or complete, reopen, archive or trash it. Empty fields stay as they are.

Inputs

Projectproject_idtext
The project, to load its choices below. Not needed when you give the id from an earlier step.
Task IDtask_idtextRequired
The task's id, from 'List tasks' or an earlier step.
Namenametext
A new title. Leave empty to keep it.
Descriptionnotestext
A new description. Leave empty to keep it.
Assigneeassigned_to_idtext
Assign the task to this person. Leave empty to keep it.
Dueduedate and time
A new due date and time. Leave empty to keep it.
Move to sectionsection_idtext
Move the task to this section. Leave empty to keep it where it is.
Statusstatustext
Complete, reopen, archive or trash the task. Trashed tasks can be restored in MeisterTask. Leave empty to keep it.One of: open, completed, completed_archived (Completed and archived), trashed.

Outputs

taskobject
The task
Example output
{
  "task": {
    "assigned_to_id": 8,
    "created_at": "2026-02-06T17:01:33.635649Z",
    "due": "2026-11-20T17:00:00Z",
    "id": 15,
    "name": "Send the invoice",
    "notes": "Before Friday",
    "project_id": 123,
    "section_id": 73,
    "section_name": "Open",
    "sequence": 100,
    "status": 1,
    "status_updated_at": "2026-05-09T14:49:18.303930Z",
    "token": "gvuUs17f",
    "tracked_time": 0,
    "updated_at": "2026-05-09T14:49:18.304227Z"
  }
}

On this page