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
| Action | What it does |
|---|---|
| Add comment | Comment on a task as the connected person. |
| Add label to task | Put a label on a task. |
| Create label | Add a label to a project. |
| Create project | Create a project with a name and optional notes. |
| Create section | Add a section (column) to a project. |
| Create subtask | Create a task under another task, in the same section. |
| Create task | Create a task in a section, or in a project's first section, with an optional description, assignee, due date and labels. |
| Delete comment | Delete a comment. |
| Delete label | Delete a label from its project, which takes it off every task that has it. |
| Get current user | Get the MeisterTask person the connection acts as: name, email and avatar. |
| Get project | Get one project with its name, notes and status. |
| Get task | Get one task with its section, assignee, due date and status. |
| List comments | List the comments on a task, with who wrote them and when. |
| List labels | List a project's labels (called tags in MeisterTask) with their colors. |
| List people | List the people you share projects with, or the people who have access to one project. |
| List project tasks | List the tasks of one project, or of one of its sections. |
| List projects | List your projects, active ones unless you choose archived or all. |
| List sections | List a project's sections (the columns tasks sit in), in board order. |
| List subtasks | List the tasks under a task. |
| List task labels | List the labels on a task. |
| List tasks | List tasks from every project you can see, filtered by status or to your own. |
| Remove label from task | Take a label off a task. |
| Update label | Rename a label or change its color. |
| Update project | Rename a project, change its description, or archive, trash or restore it. |
| Update section | Rename a section, or trash or restore it. |
| 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. |
Add comment
Comment on a task as the connected person. Markdown works.
Inputs
- Task ID
task_idtextRequired - The task's id, from 'List tasks' or an earlier step.
- Comment
texttextRequired - 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
- Project
project_idtext - The project, to load its choices below. Not needed when you give the id from an earlier step.
- Task ID
task_idtextRequired - The task's id, from 'List tasks' or an earlier step.
- Label
label_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
- Project
project_idtextRequired - The project. Pick one, or give its id from an earlier step.
- Name
nametextRequired - The label's name.
- Color
colortext - 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
- Name
nametextRequired - The project's name.
- Description
notestext - 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
- Project
project_idtextRequired - The project. Pick one, or give its id from an earlier step.
- Name
nametextRequired - 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 ID
task_idtextRequired - The task to add the subtask under, from 'List tasks' or an earlier step.
- Name
nametextRequired - The subtask's title.
- Description
notestext - The subtask's description. Markdown works.
- Assignee
assigned_to_idtext - The person the task is assigned to.
- Due
duedate 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
- Project
project_idtext - The project to add the task to. With no section, the task goes in the project's first section.
- Section
section_idtext - The section (column). Pick a project first to load its sections.
- Name
nametextRequired - The task's title.
- Description
notestext - The task's description. Markdown works.
- Assignee
assigned_to_idtext - The person the task is assigned to.
- Due
duedate and time - When the task is due.
- Labels
label_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 ID
comment_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
- Project
project_idtext - The project, to load its choices below. Not needed when you give the id from an earlier step.
- Label
label_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
- Project
project_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 ID
task_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 ID
task_idtextRequired - The task's id, from 'List tasks' or an earlier step.
- Page size
limitnumber - How many to return, 1 to 500. MeisterTask's default is 50.From 1 to 500.
- Page
pagenumber - 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
- Project
project_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
- Project
project_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
- Project
project_idtextRequired - The project. Pick one, or give its id from an earlier step.
- Section
section_idtext - Only tasks in this section. Pick a project first to load its sections.
- Status
statustext - Which tasks to include. Defaults to MeisterTask's own default.One of:
open,completed,completed_archived(Completed and archived),trashed. - Only my tasks
assigned_to_metrue/false - Only tasks assigned to you.Default:
false. - Order
sorttext - 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 size
limitnumber - How many to return, 1 to 500. MeisterTask's default is 50.From 1 to 500.
- Page
pagenumber - 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
- Status
statustext - Which projects to include. Defaults to active.One of:
active(Active (default)),archived,all(Active and archived). - Page size
limitnumber - How many to return, 1 to 500. MeisterTask's default is 50.From 1 to 500.
- Page
pagenumber - 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
- Project
project_idtextRequired - The project. Pick one, or give its id from an earlier step.
- Status
statustext - Which sections to include. Defaults to active.One of:
active(Active (default)),trashed,all(Active and trashed). - Page size
limitnumber - How many to return, 1 to 500. MeisterTask's default is 50.From 1 to 500.
- Page
pagenumber - 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 ID
task_idtextRequired - The task's id, from 'List tasks' or an earlier step.
- Page size
limitnumber - How many to return, 1 to 500. MeisterTask's default is 50.From 1 to 500.
- Page
pagenumber - 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 ID
task_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
- Status
statustext - Which tasks to include. Defaults to MeisterTask's own default.One of:
open,completed,completed_archived(Completed and archived),trashed. - Only my tasks
assigned_to_metrue/false - Only tasks assigned to you.Default:
false. - Order
sorttext - 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 size
limitnumber - How many to return, 1 to 500. MeisterTask's default is 50.From 1 to 500.
- Page
pagenumber - 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
- Project
project_idtext - The project, to load its choices below. Not needed when you give the id from an earlier step.
- Task ID
task_idtextRequired - The task's id, from 'List tasks' or an earlier step.
- Label
label_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
- Project
project_idtext - The project, to load its choices below. Not needed when you give the id from an earlier step.
- Label
label_idtextRequired - The label (tag). Pick a project first to load its labels.
- Name
nametext - A new name. Leave empty to keep it.
- Color
colortext - 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
- Project
project_idtextRequired - The project. Pick one, or give its id from an earlier step.
- Name
nametext - A new name. Leave empty to keep it.
- Description
notestext - A new description. Leave empty to keep it.
- Status
statustext - 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
- Project
project_idtext - The project, to load its choices below. Not needed when you give the id from an earlier step.
- Section
section_idtextRequired - The section (column). Pick a project first to load its sections.
- Name
nametext - A new name. Leave empty to keep it.
- Status
statustext - 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
- Project
project_idtext - The project, to load its choices below. Not needed when you give the id from an earlier step.
- Task ID
task_idtextRequired - The task's id, from 'List tasks' or an earlier step.
- Name
nametext - A new title. Leave empty to keep it.
- Description
notestext - A new description. Leave empty to keep it.
- Assignee
assigned_to_idtext - Assign the task to this person. Leave empty to keep it.
- Due
duedate and time - A new due date and time. Leave empty to keep it.
- Move to section
section_idtext - Move the task to this section. Leave empty to keep it where it is.
- Status
statustext - 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"
}
}