PluginsPlugin Todoist

ListTasks​List​Tasks

List tasks from Todoist

Retrieves a list of tasks from Todoist with optional project ID or filter query

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
Properties

Todoist API token

Your Todoist API token for authentication. Get it from https://todoist.com/app/settings/integrations/developer

Default FETCH
Possible Values
STOREFETCHFETCH_ONENONE

Fetch Type

The way to fetch data: FETCH_ONE (first task only), FETCH (all tasks in memory), or STORE (store in internal storage for large datasets)

Filter

Custom filter query (e.g., "today", "overdue", "priority 1"). Cannot be used together with projectId parameter.

Limit

Maximum number of tasks to return per page. If not set, all tasks will be fetched by automatically paginating through all results. If set, only that many tasks will be returned (defaults to 50 per page). Both /api/v1/tasks and /api/v1/tasks/filter endpoints support this parameter.

Project ID

Filter tasks by project ID. Cannot be used together with filter parameter.

Row

Single task when fetchType is FETCH_ONE

SubType object

Rows

List of tasks when fetchType is FETCH

Size

Number of tasks retrieved

Format uri

URI

URI of the stored file when fetchType is STORE