Todoist ListTasks

Todoist ListTasks

Certified

List Todoist tasks

Lists active Todoist tasks by project or filter. Defaults to paginating all tasks and returning them in memory; set fetchType to STORE to stream to internal storage for large sets.

yaml
type: io.kestra.plugin.todoist.ListTasks

List all active tasks

yaml
id: todoist_list_tasks
namespace: company.team

tasks:
  - id: list_tasks
    type: io.kestra.plugin.todoist.ListTasks
    apiToken: "{{ secret('TODOIST_API_TOKEN') }}"

List tasks for a specific project

yaml
id: todoist_list_project_tasks
namespace: company.team

tasks:
  - id: list_project_tasks
    type: io.kestra.plugin.todoist.ListTasks
    apiToken: "{{ secret('TODOIST_API_TOKEN') }}"
    projectId: "2203306141"
    fetchType: FETCH

Store tasks in internal storage for large datasets

yaml
id: todoist_store_tasks
namespace: company.team

tasks:
  - id: store_tasks
    type: io.kestra.plugin.todoist.ListTasks
    apiToken: "{{ secret('TODOIST_API_TOKEN') }}"
    fetchType: STORE

List tasks using a filter

yaml
id: todoist_list_filtered_tasks
namespace: company.team

tasks:
  - id: list_filtered_tasks
    type: io.kestra.plugin.todoist.ListTasks
    apiToken: "{{ secret('TODOIST_API_TOKEN') }}"
    filter: "today"
    fetchType: FETCH

List tasks with custom limit

yaml
id: todoist_list_tasks_with_limit
namespace: company.team

tasks:
  - id: list_tasks_limit
    type: io.kestra.plugin.todoist.ListTasks
    apiToken: "{{ secret('TODOIST_API_TOKEN') }}"
    limit: 100
    fetchType: FETCH

Fetch only the first matching task

yaml
id: todoist_list_first_task
namespace: company.team

tasks:
  - id: list_first_task
    type: io.kestra.plugin.todoist.ListTasks
    apiToken: "{{ secret('TODOIST_API_TOKEN') }}"
    filter: "today"
    fetchType: FETCH_ONE
Properties

Provide Todoist API token

Personal API token sent as Bearer auth to Todoist API v1. Keep it in a Kestra Secret; required for all Todoist tasks.

DefaultFETCH
Possible Values
STOREFETCHFETCH_ONENONE

Fetch Type

Output mode: FETCH_ONE (first task), FETCH (all in memory), STORE (write stream to internal storage kestra://); default FETCH

Filter

Custom Todoist query (e.g., "today", "overdue", "priority 1"); mutually exclusive with projectId

Limit

Maximum tasks per page. When null, the task auto-paginates all results; when set, only one page is fetched (Todoist defaults to 50). Supported on /tasks and /tasks/filter.

Reference (ref) of the pluginDefaults to apply to this task.

Project ID

Filter tasks by project ID; cannot be combined with filter

Row

Single task when fetchType is FETCH_ONE

SubTypeobject

Rows

Tasks list when fetchType is FETCH

Size

Number of tasks retrieved

Formaturi

URI

Internal storage URI (kestra://) when fetchType is STORE