Taskade

App · 31 actions

Work with your Taskade workspaces: list and create projects, add, edit, complete, move and delete tasks, set due dates, notes, assignees and custom fields, and look up AI agents.

Actions

ActionWhat it does
Assign taskAssign people to a task by their handles.
Complete projectMark a project as completed.
Complete taskMark a task as done.
Create projectCreate a project in a workspace or one of its folders, optionally with a first list of tasks.
Create several tasksAdd one task per line of text to a project, in order, at the end of the project or under a task.
Create taskAdd one task to a project: at the start or end, next to another task, or as a subtask of one.
Delete taskDelete a task from a project.
Delete task noteRemove a task's note.
Get agentGet one AI agent with its description, tone, language and commands.
Get projectGet one project's id and name.
Get taskGet one task with its text, its parent and whether it is done.
Get task dateGet a task's start and end date, if it has one.
Get task noteGet a task's note, if it has one.
List agentsList the AI agents in a folder, or in a workspace's main area.
List folder projectsList the projects in a folder, or in a workspace's main area.
List foldersList the folders of a workspace.
List my projectsList the projects the connected account has opened in Taskade, most recently opened first, a page at a time or all of them.
List project fieldsList the custom fields a project's tasks can carry.
List project membersList the people on a project with the handles that assign them to tasks.
List task assigneesList the people a task is assigned to.
List task field valuesList the custom field values a task carries.
List tasksList a project's tasks in order, with each task's parent and whether it is done.
List workspacesList the workspaces the connected account belongs to.
Move taskMove a task before or after another task of the project, or under it.
Remove task dateRemove a task's date.
Reopen taskMark a completed task as not done again.
Set task dateGive a task a start date, with an optional time and an optional end, or replace the one it has.
Set task field valueSet a custom field's value on a task.
Set task noteAdd a note to a task, or replace the one it has.
Unassign taskTake one person off a task.
Update taskReplace a task's text.

Assign task

Assign people to a task by their handles. 'List task assignees' shows who it ends up with.

Inputs

Projectproject_idtextRequired
The project. Pick one, give its id from an earlier step, or paste its taskade.com address.
Tasktask_idtextRequired
The task. Pick one from the project, or give its id from an earlier step.
PeoplehandleslistRequired
The people to assign. Pick them from the project's members.

Outputs

handleslist
The handles sent
taskobject
A task
Example output
{
  "handles": [
    "jo_bloggs"
  ],
  "task": {
    "completed": false,
    "id": "tk7Hs2Bv4Gn6Lp0C",
    "parentId": "",
    "text": "Send the weekly report"
  }
}

Complete project

Mark a project as completed.

Inputs

Projectproject_idtextRequired
The project. Pick one, give its id from an earlier step, or paste its taskade.com address.

Outputs

projectobject
A project
Example output
{
  "project": {
    "id": "pr3Wm9Qe5Ta8Ks1D",
    "name": "Launch plan"
  }
}

Complete task

Mark a task as done.

Inputs

Projectproject_idtextRequired
The project. Pick one, give its id from an earlier step, or paste its taskade.com address.
Tasktask_idtextRequired
The task. Pick one from the project, or give its id from an earlier step.

Outputs

taskobject
A task
Example output
{
  "task": {
    "completed": true,
    "id": "tk7Hs2Bv4Gn6Lp0C",
    "parentId": "",
    "text": "Send the weekly report"
  }
}

Create project

Create a project in a workspace or one of its folders, optionally with a first list of tasks.

Inputs

Workspaceworkspace_idtextRequired
The workspace. Pick one, or give its id from an earlier step.
Project namenametextRequired
The project's name, on one line.
Folderfolder_idtext
A folder of the workspace to create it in. Leave empty for the workspace's main area.
First taskstaskstext
Tasks to start the project with, one per line (up to 100).

Outputs

projectobject
A project
Example output
{
  "project": {
    "id": "pr3Wm9Qe5Ta8Ks1D",
    "name": "Launch plan"
  }
}

Create several tasks

Add one task per line of text to a project, in order, at the end of the project or under a task. Up to 100 at a time.

Inputs

Projectproject_idtextRequired
The project. Pick one, give its id from an earlier step, or paste its taskade.com address.
TaskstaskstextRequired
The tasks, one per line, or a list from an earlier step. Blank lines are skipped.
Under taskparent_task_idtext
Add them as subtasks of this task. Leave empty to add them to the project itself.
Format as Markdownas_markdowntrue/false
Read **bold**, _italic_ and links in the text as Markdown. Turn off to keep the text exactly as written.Default: true.

Outputs

countnumber
How many were returned
taskslist
The tasks created, in order
Example output
{
  "count": 1,
  "tasks": [
    {
      "completed": false,
      "id": "tk7Hs2Bv4Gn6Lp0C",
      "parentId": "",
      "text": "Send the weekly report"
    }
  ]
}

Create task

Add one task to a project: at the start or end, next to another task, or as a subtask of one.

Inputs

Projectproject_idtextRequired
The project. Pick one, give its id from an earlier step, or paste its taskade.com address.
Task textcontenttextRequired
The task's text, on one line of at most 2000 characters.
Whereplacementtext
Where the task goes. Defaults to the end of the project.One of: end (At the end of the project (default)), start (At the start of the project), after (After a task), before (Before a task), first_subtask (As the first subtask of a task), last_subtask (As the last subtask of a task). Default: end.
Next to taskreference_task_idtext
The task to place it next to, or under. Needed unless it goes at the start or end of the project.Only when Where is After a task, Before a task, As the first subtask of a task or As the last subtask of a task.
Format as Markdownas_markdowntrue/false
Read **bold**, _italic_ and links in the text as Markdown. Turn off to keep the text exactly as written.Default: true.

Outputs

taskobject
A task
Example output
{
  "task": {
    "completed": false,
    "id": "tk7Hs2Bv4Gn6Lp0C",
    "parentId": "",
    "text": "Send the weekly report"
  }
}

Delete task

Delete a task from a project.

Inputs

Projectproject_idtextRequired
The project. Pick one, give its id from an earlier step, or paste its taskade.com address.
Tasktask_idtextRequired
The task. Pick one from the project, or give its id from an earlier step.

Outputs

deletedtrue/false
Always true once deleted
project_idtext
The project it was in
task_idtext
The task the change was made on
Example output
{
  "deleted": true,
  "project_id": "pr3Wm9Qe5Ta8Ks1D",
  "task_id": "tk7Hs2Bv4Gn6Lp0C"
}

Delete task note

Remove a task's note.

Inputs

Projectproject_idtextRequired
The project. Pick one, give its id from an earlier step, or paste its taskade.com address.
Tasktask_idtextRequired
The task. Pick one from the project, or give its id from an earlier step.

Outputs

deletedtrue/false
Always true once deleted
project_idtext
The project it was in
task_idtext
The task the change was made on
Example output
{
  "deleted": true,
  "project_id": "pr3Wm9Qe5Ta8Ks1D",
  "task_id": "tk7Hs2Bv4Gn6Lp0C"
}

Get agent

Get one AI agent with its description, tone, language and commands.

Inputs

Agent IDagent_idtextRequired
The agent's id, from 'List agents'.

Outputs

agentobject
An AI agent
Example output
{
  "agent": {
    "data": {
      "avatar": {
        "data": {
          "value": "\ud83e\udd16"
        },
        "type": "emoji"
      },
      "commands": [
        {
          "id": "cm1",
          "mode": "default",
          "name": "Summarize",
          "prompt": "Summarize the thread"
        }
      ],
      "description": "You answer customer questions about orders.",
      "inputPlaceholder": "Ask about an order",
      "knowledgeEnabled": true,
      "language": "English",
      "tone": "friendly"
    },
    "id": "ag5Rx1Cz8Ud3Mf7T",
    "name": "Support helper",
    "space_id": "sp8Kd2Lq7Zm3Xw9R"
  }
}

Get project

Get one project's id and name.

Inputs

Projectproject_idtextRequired
The project. Pick one, give its id from an earlier step, or paste its taskade.com address.

Outputs

projectobject
A project
Example output
{
  "project": {
    "id": "pr3Wm9Qe5Ta8Ks1D",
    "name": "Launch plan"
  }
}

Get task

Get one task with its text, its parent and whether it is done.

Inputs

Projectproject_idtextRequired
The project. Pick one, give its id from an earlier step, or paste its taskade.com address.
Tasktask_idtextRequired
The task. Pick one from the project, or give its id from an earlier step.

Outputs

taskobject
A task
Example output
{
  "task": {
    "completed": false,
    "id": "tk7Hs2Bv4Gn6Lp0C",
    "parentId": "",
    "text": "Send the weekly report"
  }
}

Get task date

Get a task's start and end date, if it has one.

Inputs

Projectproject_idtextRequired
The project. Pick one, give its id from an earlier step, or paste its taskade.com address.
Tasktask_idtextRequired
The task. Pick one from the project, or give its id from an earlier step.

Outputs

has_datetrue/false
Whether the task has a date
task_dateobject
A task's dates
Example output
{
  "has_date": true,
  "task_date": {
    "end": {
      "date": "2026-11-21",
      "time": "17:00:00",
      "timezone": "America/New_York"
    },
    "start": {
      "date": "2026-11-20",
      "time": "09:00:00",
      "timezone": "America/New_York"
    }
  }
}

Get task note

Get a task's note, if it has one.

Inputs

Projectproject_idtextRequired
The project. Pick one, give its id from an earlier step, or paste its taskade.com address.
Tasktask_idtextRequired
The task. Pick one from the project, or give its id from an earlier step.

Outputs

has_notetrue/false
Whether the task has a note
noteobject
A task's note
Example output
{
  "has_note": true,
  "note": {
    "type": "text/markdown",
    "value": "Ask finance for the totals"
  }
}

List agents

List the AI agents in a folder, or in a workspace's main area.

Inputs

Folderfolder_idtextRequired
A folder, or a workspace to use its main area. Pick one, or give its id from an earlier step.
Page sizelimitnumber
How many to return per page, 1 to 100.From 1 to 100.
Pagepagenumber
Which page to read, starting at 1. Use 'next_page' from an earlier page.At least 1.

Outputs

agentslist
The AI agents
countnumber
How many records were returned
has_moretrue/false
True when the page was full, so another may follow
next_pagenumber
Pass as 'page' for the next page; 0 on the last one
pagenumber
The last page read
truncatedtrue/false
True when 'Read every page' stopped at its page limit
Example output
{
  "agents": [
    {
      "data": {
        "avatar": {
          "data": {
            "value": "\ud83e\udd16"
          },
          "type": "emoji"
        },
        "commands": [
          {
            "id": "cm1",
            "mode": "default",
            "name": "Summarize",
            "prompt": "Summarize the thread"
          }
        ],
        "description": "You answer customer questions about orders.",
        "inputPlaceholder": "Ask about an order",
        "knowledgeEnabled": true,
        "language": "English",
        "tone": "friendly"
      },
      "id": "ag5Rx1Cz8Ud3Mf7T",
      "name": "Support helper",
      "space_id": "sp8Kd2Lq7Zm3Xw9R"
    }
  ],
  "count": 1,
  "has_more": false,
  "next_page": 0,
  "page": 1,
  "truncated": false
}

List folder projects

List the projects in a folder, or in a workspace's main area.

Inputs

Folderfolder_idtextRequired
A folder, or a workspace to use its main area. Pick one, or give its id from an earlier step.

Outputs

countnumber
How many were returned
projectslist
The projects
Example output
{
  "count": 1,
  "projects": [
    {
      "id": "pr3Wm9Qe5Ta8Ks1D",
      "name": "Launch plan"
    }
  ]
}

List folders

List the folders of a workspace.

Inputs

Workspaceworkspace_idtextRequired
The workspace. Pick one, or give its id from an earlier step.

Outputs

countnumber
How many were returned
folderslist
The folders
Example output
{
  "count": 1,
  "folders": [
    {
      "id": "fo4Nt6Yb1Hc5Vj2P",
      "name": "Marketing"
    }
  ]
}

List my projects

List the projects the connected account has opened in Taskade, most recently opened first, a page at a time or all of them. A project made by 'Create project' appears here only after it is opened in Taskade; 'List projects in folder' always lists it.

Inputs

Ordersorttext
Which projects come first. Defaults to most recently opened.One of: viewed-desc (Most recently opened first (default)), viewed-asc (Least recently opened first). Default: viewed-desc.
Page sizelimitnumber
How many to return per page, 1 to 100.From 1 to 100.
Pagepagenumber
Which page to read, starting at 1. Use 'next_page' from an earlier page.At least 1.
Read every pagefetch_alltrue/false
Keep reading pages until there are no more, up to 20 pages. 'truncated' says when it stopped early.Default: false.

Outputs

countnumber
How many records were returned
has_moretrue/false
True when the page was full, so another may follow
next_pagenumber
Pass as 'page' for the next page; 0 on the last one
pagenumber
The last page read
projectslist
The projects
truncatedtrue/false
True when 'Read every page' stopped at its page limit
Example output
{
  "count": 1,
  "has_more": false,
  "next_page": 0,
  "page": 1,
  "projects": [
    {
      "id": "pr3Wm9Qe5Ta8Ks1D",
      "name": "Launch plan"
    }
  ],
  "truncated": false
}

List project fields

List the custom fields a project's tasks can carry.

Inputs

Projectproject_idtextRequired
The project. Pick one, give its id from an earlier step, or paste its taskade.com address.

Outputs

countnumber
How many were returned
fieldslist
The custom fields
Example output
{
  "count": 1,
  "fields": [
    {
      "data": {
        "name": "Cost",
        "type": "number"
      },
      "id": "fl9Qa3Wd6Ez2Rt5Y"
    }
  ]
}

List project members

List the people on a project with the handles that assign them to tasks.

Inputs

Projectproject_idtextRequired
The project. Pick one, give its id from an earlier step, or paste its taskade.com address.
Page sizelimitnumber
How many to return per page, 1 to 100.From 1 to 100.
Pagepagenumber
Which page to read, starting at 1. Use 'next_page' from an earlier page.At least 1.

Outputs

countnumber
How many records were returned
has_moretrue/false
True when the page was full, so another may follow
memberslist
The people on the project
next_pagenumber
Pass as 'page' for the next page; 0 on the last one
pagenumber
The last page read
truncatedtrue/false
True when 'Read every page' stopped at its page limit
Example output
{
  "count": 1,
  "has_more": false,
  "members": [
    {
      "displayName": "Jo Bloggs",
      "handle": "jo_bloggs"
    }
  ],
  "next_page": 0,
  "page": 1,
  "truncated": false
}

List task assignees

List the people a task is assigned to.

Inputs

Projectproject_idtextRequired
The project. Pick one, give its id from an earlier step, or paste its taskade.com address.
Tasktask_idtextRequired
The task. Pick one from the project, or give its id from an earlier step.

Outputs

assigneeslist
The people assigned
countnumber
How many were returned
Example output
{
  "assignees": [
    {
      "displayName": "Jo Bloggs",
      "handle": "jo_bloggs"
    }
  ],
  "count": 1
}

List task field values

List the custom field values a task carries.

Inputs

Projectproject_idtextRequired
The project. Pick one, give its id from an earlier step, or paste its taskade.com address.
Tasktask_idtextRequired
The task. Pick one from the project, or give its id from an earlier step.

Outputs

countnumber
How many were returned
valueslist
The custom field values
Example output
{
  "count": 1,
  "values": [
    {
      "fieldId": "fl9Qa3Wd6Ez2Rt5Y",
      "value": "42"
    }
  ]
}

List tasks

List a project's tasks in order, with each task's parent and whether it is done. Read a page at a time or all of them.

Inputs

Projectproject_idtextRequired
The project. Pick one, give its id from an earlier step, or paste its taskade.com address.
Showstatustext
Which tasks to keep. Defaults to all.One of: all (All tasks (default)), open (Not completed), completed. Default: all.
Page sizelimitnumber
How many tasks to read per page, 1 to 1000. Defaults to 100.From 1 to 1000.
Read every pagefetch_alltrue/false
Keep reading pages until there are no more, up to 20 pages. 'truncated' says when it stopped early.Default: false.
After taskaftertext
Start after this task. Use 'next_cursor' from an earlier page.
Before taskbeforetext
End before this task. Use 'previous_cursor' to go back a page.

Outputs

countnumber
How many tasks were returned
has_moretrue/false
True when the page was full, so more may follow
next_cursortext
Pass as 'after' for the next page; empty on the last one
previous_cursortext
Pass as 'before' to go back a page; empty when none were read
taskslist
The tasks
truncatedtrue/false
True when 'Read every page' stopped at its page limit
Example output
{
  "count": 1,
  "has_more": false,
  "next_cursor": "",
  "previous_cursor": "tk7Hs2Bv4Gn6Lp0C",
  "tasks": [
    {
      "completed": false,
      "id": "tk7Hs2Bv4Gn6Lp0C",
      "parentId": "",
      "text": "Send the weekly report"
    }
  ],
  "truncated": false
}

List workspaces

List the workspaces the connected account belongs to.

Inputs

None.

Outputs

countnumber
How many were returned
workspaceslist
The workspaces
Example output
{
  "count": 1,
  "workspaces": [
    {
      "id": "sp8Kd2Lq7Zm3Xw9R",
      "name": "Acme Team"
    }
  ]
}

Move task

Move a task before or after another task of the project, or under it.

Inputs

Projectproject_idtextRequired
The project. Pick one, give its id from an earlier step, or paste its taskade.com address.
Tasktask_idtextRequired
The task. Pick one from the project, or give its id from an earlier step.
Target tasktarget_task_idtextRequired
The task to move it next to, or under.
Positionpositiontext
Where it goes in relation to the target. Defaults to after.One of: afterend (After the target task (default)), beforebegin (Before the target task), afterbegin (As the first subtask of the target task), beforeend (As the last subtask of the target task). Default: afterend.

Outputs

taskobject
A task
Example output
{
  "task": {
    "completed": false,
    "id": "tk7Hs2Bv4Gn6Lp0C",
    "parentId": "",
    "text": "Send the weekly report"
  }
}

Remove task date

Remove a task's date.

Inputs

Projectproject_idtextRequired
The project. Pick one, give its id from an earlier step, or paste its taskade.com address.
Tasktask_idtextRequired
The task. Pick one from the project, or give its id from an earlier step.

Outputs

taskobject
A task
Example output
{
  "task": {
    "completed": false,
    "id": "tk7Hs2Bv4Gn6Lp0C",
    "parentId": "",
    "text": "Send the weekly report"
  }
}

Reopen task

Mark a completed task as not done again.

Inputs

Projectproject_idtextRequired
The project. Pick one, give its id from an earlier step, or paste its taskade.com address.
Tasktask_idtextRequired
The task. Pick one from the project, or give its id from an earlier step.

Outputs

taskobject
A task
Example output
{
  "task": {
    "completed": false,
    "id": "tk7Hs2Bv4Gn6Lp0C",
    "parentId": "",
    "text": "Send the weekly report"
  }
}

Set task date

Give a task a start date, with an optional time and an optional end, or replace the one it has.

Inputs

Projectproject_idtextRequired
The project. Pick one, give its id from an earlier step, or paste its taskade.com address.
Tasktask_idtextRequired
The task. Pick one from the project, or give its id from an earlier step.
Start datestart_datedateRequired
The day the task starts or is due.
Start timestart_timetime
The time it starts. Leave empty for an all-day date, which Taskade keeps as midnight in your account's time zone.
End dateend_datedate
The day it ends. Leave empty and Taskade ends it a day after it starts.
End timeend_timetime
The time it ends. Needs an end date.
Time zonetime_zonetext
The time zone the times are in, such as America/New_York. Used only when a time is given.

Outputs

taskobject
A task
task_dateobject
A task's dates
Example output
{
  "task": {
    "completed": false,
    "id": "tk7Hs2Bv4Gn6Lp0C",
    "parentId": "",
    "text": "Send the weekly report"
  },
  "task_date": {
    "end": {
      "date": "2026-11-21",
      "time": "17:00:00",
      "timezone": "America/New_York"
    },
    "start": {
      "date": "2026-11-20",
      "time": "09:00:00",
      "timezone": "America/New_York"
    }
  }
}

Set task field value

Set a custom field's value on a task.

Inputs

Projectproject_idtextRequired
The project. Pick one, give its id from an earlier step, or paste its taskade.com address.
Tasktask_idtextRequired
The task. Pick one from the project, or give its id from an earlier step.
Fieldfield_idtextRequired
The custom field. Pick one from the project.
ValuevaluetextRequired
The value to store: text, or a number for a number field.

Outputs

field_idtext
The field set
task_idtext
The task changed
updatedtrue/false
Always true once set
valuetext
The value sent
Example output
{
  "field_id": "fl9Qa3Wd6Ez2Rt5Y",
  "task_id": "tk7Hs2Bv4Gn6Lp0C",
  "updated": true,
  "value": "42"
}

Set task note

Add a note to a task, or replace the one it has.

Inputs

Projectproject_idtextRequired
The project. Pick one, give its id from an earlier step, or paste its taskade.com address.
Tasktask_idtextRequired
The task. Pick one from the project, or give its id from an earlier step.
NotenotetextRequired
The note's text, on one line.
Note formatnote_formattext
Whether the note is Markdown or plain text. Defaults to Markdown.One of: text/markdown (Markdown (default)), text/plain (Plain text). Default: text/markdown.

Outputs

noteobject
A task's note
Example output
{
  "note": {
    "type": "text/markdown",
    "value": "Ask finance for the totals"
  }
}

Unassign task

Take one person off a task.

Inputs

Projectproject_idtextRequired
The project. Pick one, give its id from an earlier step, or paste its taskade.com address.
Tasktask_idtextRequired
The task. Pick one from the project, or give its id from an earlier step.
PersonhandletextRequired
The person to take off. Pick one of the project's members.

Outputs

handletext
The handle taken off the task
taskobject
A task
Example output
{
  "handle": "jo_bloggs",
  "task": {
    "completed": false,
    "id": "tk7Hs2Bv4Gn6Lp0C",
    "parentId": "",
    "text": "Send the weekly report"
  }
}

Update task

Replace a task's text.

Inputs

Projectproject_idtextRequired
The project. Pick one, give its id from an earlier step, or paste its taskade.com address.
Tasktask_idtextRequired
The task. Pick one from the project, or give its id from an earlier step.
New task textcontenttextRequired
The task's new text, on one line of at most 2000 characters.
Format as Markdownas_markdowntrue/false
Read **bold**, _italic_ and links in the text as Markdown. Turn off to keep the text exactly as written.Default: true.

Outputs

taskobject
A task
Example output
{
  "task": {
    "completed": false,
    "id": "tk7Hs2Bv4Gn6Lp0C",
    "parentId": "",
    "text": "Send the weekly report"
  }
}

On this page