Skip to contents

Token Management

Functions for managing your Todoist API token

get_todoist_api_token()
Get token stored by keyring
set_todoist_api_token()
Set todoist API token
update_todoist_api_token()
Update Todoist Api Token
delete_todoist_api_token()
Delete todoist api token
ask_todoist_api_token()
Pop-up to save the token

Projects

Create, read, update, and delete projects

add_project()
Add a new project
get_project()
Get a single project by ID
get_project_id()
Get id of project
get_all_projects()
List of projects
get_archived_projects()
Get archived projects
update_project()
Update a project
archive_project()
Archive a project
unarchive_project()
Unarchive a project
delete_project()
Delete a project

Tasks

Manage tasks in your projects

add_tasks_in_project()
Add tasks in project
add_tasks_in_project_from_df()
Add tasks in project
add_responsible_to_task()
Add responsible to a task
get_task()
Get a single task by ID
get_tasks()
List of tasks
get_tasks_of_project()
List of tasks of project
get_tasks_by_filter()
Get tasks by filter query
get_completed_tasks()
Get completed tasks
update_task()
Update a task
move_task()
Move a task to another project or section
close_task()
Close (complete) a task
reopen_task()
Reopen (uncomplete) a task
delete_task()
Delete a task
quick_add_task()
Quick add a task using natural language

Sections

Organize tasks with sections

add_section()
Add section
get_section()
Get a single section by ID
get_section_id()
Get section id
get_all_sections()
Get all sections
update_section()
Update a section
move_section()
Move a section to another project
archive_section()
Archive a section
unarchive_section()
Unarchive a section
delete_section()
Delete a section

Labels

Tag tasks with labels

add_label()
Add a new label
get_label()
Get a single label by ID
get_label_id()
Get label id by name
get_all_labels()
Get all labels
get_shared_labels()
Get shared labels
update_label()
Update a label
rename_shared_label()
Rename a shared label
remove_shared_label()
Remove a shared label
delete_label()
Delete a label

Comments

Add comments to tasks and projects

add_comment()
Add a comment to a task or project
get_comment()
Get a single comment by ID
get_comments()
Get comments
update_comment()
Update a comment
delete_comment()
Delete a comment

Filters

Create and manage custom filters

add_filter()
Add a new filter
get_filter()
Get a single filter by ID
get_filter_id()
Get filter id by name
get_all_filters()
Get all filters
update_filter()
Update a filter
delete_filter()
Delete a filter

Reminders

Set reminders for tasks

add_reminder()
Add a reminder to a task
get_all_reminders()
Get all reminders
update_reminder()
Update a reminder
delete_reminder()
Delete a reminder

Collaboration

Share projects and manage collaborators

add_user_in_project()
Add one user
add_users_in_project()
Add a list of users
get_all_users()
Get users
get_users_in_project()
Get users in projects
delete_collaborator()
Delete a collaborator from a project
accept_invitation()
Accept a project invitation
reject_invitation()
Reject a project invitation
delete_invitation()
Delete an invitation

User & Stats

Get user information and productivity stats

get_user_info()
Get current user info
get_productivity_stats()
Get productivity stats

Workspaces

Manage workspaces (team features)

get_all_workspaces()
Get all workspaces
get_workspace_users()
Get workspace users
update_workspace()
Update a workspace
invite_to_workspace()
Invite user to workspace
leave_workspace()
Leave a workspace

Activity Logs

View activity history

get_activity_logs()
Get activity logs

Backups

Download account backups

get_backups()
Get list of backups
download_backup()
Download a backup

Templates

Import and export project templates

export_template()
Export a project as a template
import_template()
Import a template into a project

File Uploads

Attach files to comments

upload_file()
Upload a file
delete_upload()
Delete an uploaded file

Utilities

Helper functions

get_all_data()
Get all objects inside a list
open_todoist_website_profile()
Open todoist website

Internal

Internal functions (not for direct use)

call_api()
Call the Sync API
call_api_rest()
Call the REST API
escape_json()
Escape special characters for JSON
get_users_id()
Get users id
random_key()
Random key