# Taskade

> 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.

App · 31 actions. Web page: https://docs.lodol.com/docs/integrations/taskade

## Actions

### Assign task

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

**Inputs**

- Project (`project_id`, text, required): The project. Pick one, give its id from an earlier step, or paste its taskade.com address.
- Task (`task_id`, text, required): The task. Pick one from the project, or give its id from an earlier step.
- People (`handles`, list, required): The people to assign. Pick them from the project's members.

**Outputs**

- `handles` (list): The handles sent
- `task` (object): A task

**Example output**

```json
{
  "handles": [
    "jo_bloggs"
  ],
  "task": {
    "completed": false,
    "id": "tk7Hs2Bv4Gn6Lp0C",
    "parentId": "",
    "text": "Send the weekly report"
  }
}
```

### Complete project

Mark a project as completed.

**Inputs**

- Project (`project_id`, text, required): The project. Pick one, give its id from an earlier step, or paste its taskade.com address.

**Outputs**

- `project` (object): A project

**Example output**

```json
{
  "project": {
    "id": "pr3Wm9Qe5Ta8Ks1D",
    "name": "Launch plan"
  }
}
```

### Complete task

Mark a task as done.

**Inputs**

- Project (`project_id`, text, required): The project. Pick one, give its id from an earlier step, or paste its taskade.com address.
- Task (`task_id`, text, required): The task. Pick one from the project, or give its id from an earlier step.

**Outputs**

- `task` (object): A task

**Example output**

```json
{
  "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**

- Workspace (`workspace_id`, text, required): The workspace. Pick one, or give its id from an earlier step.
- Project name (`name`, text, required): The project's name, on one line.
- Folder (`folder_id`, text): A folder of the workspace to create it in. Leave empty for the workspace's main area.
- First tasks (`tasks`, text): Tasks to start the project with, one per line (up to 100).

**Outputs**

- `project` (object): A project

**Example output**

```json
{
  "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**

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

**Outputs**

- `count` (number): How many were returned
- `tasks` (list): The tasks created, in order

**Example output**

```json
{
  "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**

- Project (`project_id`, text, required): The project. Pick one, give its id from an earlier step, or paste its taskade.com address.
- Task text (`content`, text, required): The task's text, on one line of at most 2000 characters.
- Where (`placement`, text): 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 task (`reference_task_id`, text): 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 Markdown (`as_markdown`, true/false): Read **bold**, _italic_ and links in the text as Markdown. Turn off to keep the text exactly as written. Default: `true`.

**Outputs**

- `task` (object): A task

**Example output**

```json
{
  "task": {
    "completed": false,
    "id": "tk7Hs2Bv4Gn6Lp0C",
    "parentId": "",
    "text": "Send the weekly report"
  }
}
```

### Delete task

Delete a task from a project.

**Inputs**

- Project (`project_id`, text, required): The project. Pick one, give its id from an earlier step, or paste its taskade.com address.
- Task (`task_id`, text, required): The task. Pick one from the project, or give its id from an earlier step.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `project_id` (text): The project it was in
- `task_id` (text): The task the change was made on

**Example output**

```json
{
  "deleted": true,
  "project_id": "pr3Wm9Qe5Ta8Ks1D",
  "task_id": "tk7Hs2Bv4Gn6Lp0C"
}
```

### Delete task note

Remove a task's note.

**Inputs**

- Project (`project_id`, text, required): The project. Pick one, give its id from an earlier step, or paste its taskade.com address.
- Task (`task_id`, text, required): The task. Pick one from the project, or give its id from an earlier step.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `project_id` (text): The project it was in
- `task_id` (text): The task the change was made on

**Example output**

```json
{
  "deleted": true,
  "project_id": "pr3Wm9Qe5Ta8Ks1D",
  "task_id": "tk7Hs2Bv4Gn6Lp0C"
}
```

### Get agent

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

**Inputs**

- Agent ID (`agent_id`, text, required): The agent's id, from 'List agents'.

**Outputs**

- `agent` (object): An AI agent

**Example output**

```json
{
  "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**

- Project (`project_id`, text, required): The project. Pick one, give its id from an earlier step, or paste its taskade.com address.

**Outputs**

- `project` (object): A project

**Example output**

```json
{
  "project": {
    "id": "pr3Wm9Qe5Ta8Ks1D",
    "name": "Launch plan"
  }
}
```

### Get task

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

**Inputs**

- Project (`project_id`, text, required): The project. Pick one, give its id from an earlier step, or paste its taskade.com address.
- Task (`task_id`, text, required): The task. Pick one from the project, or give its id from an earlier step.

**Outputs**

- `task` (object): A task

**Example output**

```json
{
  "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**

- Project (`project_id`, text, required): The project. Pick one, give its id from an earlier step, or paste its taskade.com address.
- Task (`task_id`, text, required): The task. Pick one from the project, or give its id from an earlier step.

**Outputs**

- `has_date` (true/false): Whether the task has a date
- `task_date` (object): A task's dates

**Example output**

```json
{
  "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**

- Project (`project_id`, text, required): The project. Pick one, give its id from an earlier step, or paste its taskade.com address.
- Task (`task_id`, text, required): The task. Pick one from the project, or give its id from an earlier step.

**Outputs**

- `has_note` (true/false): Whether the task has a note
- `note` (object): A task's note

**Example output**

```json
{
  "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**

- Folder (`folder_id`, text, required): A folder, or a workspace to use its main area. Pick one, or give its id from an earlier step.
- Page size (`limit`, number): How many to return per page, 1 to 100. From 1 to 100.
- Page (`page`, number): Which page to read, starting at 1. Use 'next_page' from an earlier page. At least 1.

**Outputs**

- `agents` (list): The AI agents
- `count` (number): How many records were returned
- `has_more` (true/false): True when the page was full, so another may follow
- `next_page` (number): Pass as 'page' for the next page; 0 on the last one
- `page` (number): The last page read
- `truncated` (true/false): True when 'Read every page' stopped at its page limit

**Example output**

```json
{
  "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**

- Folder (`folder_id`, text, required): A folder, or a workspace to use its main area. Pick one, or give its id from an earlier step.

**Outputs**

- `count` (number): How many were returned
- `projects` (list): The projects

**Example output**

```json
{
  "count": 1,
  "projects": [
    {
      "id": "pr3Wm9Qe5Ta8Ks1D",
      "name": "Launch plan"
    }
  ]
}
```

### List folders

List the folders of a workspace.

**Inputs**

- Workspace (`workspace_id`, text, required): The workspace. Pick one, or give its id from an earlier step.

**Outputs**

- `count` (number): How many were returned
- `folders` (list): The folders

**Example output**

```json
{
  "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**

- Order (`sort`, text): 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 size (`limit`, number): How many to return per page, 1 to 100. From 1 to 100.
- Page (`page`, number): Which page to read, starting at 1. Use 'next_page' from an earlier page. At least 1.
- Read every page (`fetch_all`, true/false): Keep reading pages until there are no more, up to 20 pages. 'truncated' says when it stopped early. Default: `false`.

**Outputs**

- `count` (number): How many records were returned
- `has_more` (true/false): True when the page was full, so another may follow
- `next_page` (number): Pass as 'page' for the next page; 0 on the last one
- `page` (number): The last page read
- `projects` (list): The projects
- `truncated` (true/false): True when 'Read every page' stopped at its page limit

**Example output**

```json
{
  "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**

- Project (`project_id`, text, required): The project. Pick one, give its id from an earlier step, or paste its taskade.com address.

**Outputs**

- `count` (number): How many were returned
- `fields` (list): The custom fields

**Example output**

```json
{
  "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**

- Project (`project_id`, text, required): The project. Pick one, give its id from an earlier step, or paste its taskade.com address.
- Page size (`limit`, number): How many to return per page, 1 to 100. From 1 to 100.
- Page (`page`, number): Which page to read, starting at 1. Use 'next_page' from an earlier page. At least 1.

**Outputs**

- `count` (number): How many records were returned
- `has_more` (true/false): True when the page was full, so another may follow
- `members` (list): The people on the project
- `next_page` (number): Pass as 'page' for the next page; 0 on the last one
- `page` (number): The last page read
- `truncated` (true/false): True when 'Read every page' stopped at its page limit

**Example output**

```json
{
  "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**

- Project (`project_id`, text, required): The project. Pick one, give its id from an earlier step, or paste its taskade.com address.
- Task (`task_id`, text, required): The task. Pick one from the project, or give its id from an earlier step.

**Outputs**

- `assignees` (list): The people assigned
- `count` (number): How many were returned

**Example output**

```json
{
  "assignees": [
    {
      "displayName": "Jo Bloggs",
      "handle": "jo_bloggs"
    }
  ],
  "count": 1
}
```

### List task field values

List the custom field values a task carries.

**Inputs**

- Project (`project_id`, text, required): The project. Pick one, give its id from an earlier step, or paste its taskade.com address.
- Task (`task_id`, text, required): The task. Pick one from the project, or give its id from an earlier step.

**Outputs**

- `count` (number): How many were returned
- `values` (list): The custom field values

**Example output**

```json
{
  "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**

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

**Outputs**

- `count` (number): How many tasks were returned
- `has_more` (true/false): True when the page was full, so more may follow
- `next_cursor` (text): Pass as 'after' for the next page; empty on the last one
- `previous_cursor` (text): Pass as 'before' to go back a page; empty when none were read
- `tasks` (list): The tasks
- `truncated` (true/false): True when 'Read every page' stopped at its page limit

**Example output**

```json
{
  "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**

- `count` (number): How many were returned
- `workspaces` (list): The workspaces

**Example output**

```json
{
  "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**

- Project (`project_id`, text, required): The project. Pick one, give its id from an earlier step, or paste its taskade.com address.
- Task (`task_id`, text, required): The task. Pick one from the project, or give its id from an earlier step.
- Target task (`target_task_id`, text, required): The task to move it next to, or under.
- Position (`position`, text): 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**

- `task` (object): A task

**Example output**

```json
{
  "task": {
    "completed": false,
    "id": "tk7Hs2Bv4Gn6Lp0C",
    "parentId": "",
    "text": "Send the weekly report"
  }
}
```

### Remove task date

Remove a task's date.

**Inputs**

- Project (`project_id`, text, required): The project. Pick one, give its id from an earlier step, or paste its taskade.com address.
- Task (`task_id`, text, required): The task. Pick one from the project, or give its id from an earlier step.

**Outputs**

- `task` (object): A task

**Example output**

```json
{
  "task": {
    "completed": false,
    "id": "tk7Hs2Bv4Gn6Lp0C",
    "parentId": "",
    "text": "Send the weekly report"
  }
}
```

### Reopen task

Mark a completed task as not done again.

**Inputs**

- Project (`project_id`, text, required): The project. Pick one, give its id from an earlier step, or paste its taskade.com address.
- Task (`task_id`, text, required): The task. Pick one from the project, or give its id from an earlier step.

**Outputs**

- `task` (object): A task

**Example output**

```json
{
  "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**

- Project (`project_id`, text, required): The project. Pick one, give its id from an earlier step, or paste its taskade.com address.
- Task (`task_id`, text, required): The task. Pick one from the project, or give its id from an earlier step.
- Start date (`start_date`, date, required): The day the task starts or is due.
- Start time (`start_time`, time): The time it starts. Leave empty for an all-day date, which Taskade keeps as midnight in your account's time zone.
- End date (`end_date`, date): The day it ends. Leave empty and Taskade ends it a day after it starts.
- End time (`end_time`, time): The time it ends. Needs an end date.
- Time zone (`time_zone`, text): The time zone the times are in, such as America/New_York. Used only when a time is given.

**Outputs**

- `task` (object): A task
- `task_date` (object): A task's dates

**Example output**

```json
{
  "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**

- Project (`project_id`, text, required): The project. Pick one, give its id from an earlier step, or paste its taskade.com address.
- Task (`task_id`, text, required): The task. Pick one from the project, or give its id from an earlier step.
- Field (`field_id`, text, required): The custom field. Pick one from the project.
- Value (`value`, text, required): The value to store: text, or a number for a number field.

**Outputs**

- `field_id` (text): The field set
- `task_id` (text): The task changed
- `updated` (true/false): Always true once set
- `value` (text): The value sent

**Example output**

```json
{
  "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**

- Project (`project_id`, text, required): The project. Pick one, give its id from an earlier step, or paste its taskade.com address.
- Task (`task_id`, text, required): The task. Pick one from the project, or give its id from an earlier step.
- Note (`note`, text, required): The note's text, on one line.
- Note format (`note_format`, text): 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**

- `note` (object): A task's note

**Example output**

```json
{
  "note": {
    "type": "text/markdown",
    "value": "Ask finance for the totals"
  }
}
```

### Unassign task

Take one person off a task.

**Inputs**

- Project (`project_id`, text, required): The project. Pick one, give its id from an earlier step, or paste its taskade.com address.
- Task (`task_id`, text, required): The task. Pick one from the project, or give its id from an earlier step.
- Person (`handle`, text, required): The person to take off. Pick one of the project's members.

**Outputs**

- `handle` (text): The handle taken off the task
- `task` (object): A task

**Example output**

```json
{
  "handle": "jo_bloggs",
  "task": {
    "completed": false,
    "id": "tk7Hs2Bv4Gn6Lp0C",
    "parentId": "",
    "text": "Send the weekly report"
  }
}
```

### Update task

Replace a task's text.

**Inputs**

- Project (`project_id`, text, required): The project. Pick one, give its id from an earlier step, or paste its taskade.com address.
- Task (`task_id`, text, required): The task. Pick one from the project, or give its id from an earlier step.
- New task text (`content`, text, required): The task's new text, on one line of at most 2000 characters.
- Format as Markdown (`as_markdown`, true/false): Read **bold**, _italic_ and links in the text as Markdown. Turn off to keep the text exactly as written. Default: `true`.

**Outputs**

- `task` (object): A task

**Example output**

```json
{
  "task": {
    "completed": false,
    "id": "tk7Hs2Bv4Gn6Lp0C",
    "parentId": "",
    "text": "Send the weekly report"
  }
}
```
