
Todoist ListTasks
CertifiedList Todoist tasks
Todoist ListTasks
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.
type: io.kestra.plugin.todoist.ListTasksExamples
List all active tasks
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
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
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
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
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
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
apiToken *Requiredstring
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.
fetchType string
FETCHSTOREFETCHFETCH_ONENONEFetch Type
Output mode: FETCH_ONE (first task), FETCH (all in memory), STORE (write stream to internal storage kestra://); default FETCH
filter string
Filter
Custom Todoist query (e.g., "today", "overdue", "priority 1"); mutually exclusive with projectId
limit integerstring
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.
pluginDefaultsRef Non-dynamicstring
Reference (ref) of the pluginDefaults to apply to this task.
projectId string
Project ID
Filter tasks by project ID; cannot be combined with filter
Outputs
row object
Row
Single task when fetchType is FETCH_ONE
rows array
Rows
Tasks list when fetchType is FETCH
size integer
Size
Number of tasks retrieved
uri string
uriURI
Internal storage URI (kestra://) when fetchType is STORE