Menu

Samenvatting van de Todoist API

Met de Todoist API bouw je integraties die taken, projecten en teamwerk automatiseren over heen je eigen stack. De API is volledig gedocumenteerd met een OpenAPI 3.1-spec en ondersteunt zowel persoonlijke tokens als OAuth 2.0 voor publieke apps.
  • Taken en projecten: Maak taken en projecten aan, werk ze bij, archiveer, heropen en filter op tags, secties of deadlines via de search- en filter-endpoints.
  • Werkruimtes en teams: Beheer workspaces, nodig gebruikers uit, accepteer/wijs invitations af en stel permissies per project in.
  • Labels en secties: Organiseer taken met persoonlijke en gedeelde labels, hernoem of verwijder shared labels en beheer secties binnen projecten.
  • Herinneringen: Plan tijd- en locatie-gebaseerde herinneringen en synchroniseer die met je mobiele of desktop-app.
  • Templates en backups: Exporteer projecten als sjabloon of bestand, importeer templates in nieuwe projecten en download volledige backups.
API Quick Facts REST
  • Authenticatie OAuth2, Bearer Token
  • Methods GET (42)DELETE (13)POST (40)PUT (4)
  • Rate limits 450 requests per 15 minuten per user/API-token
  • Webhooks Beschikbaar
  • Sandbox Niet beschikbaar
  • Response format JSON
  • Versionering URL-based
  • SDK's Python, Node.js

Laatste ontwikkelingen bij de Todoist API

Todoist introduceerde in 2013 een eerste publieke Sync API (v7/v8/v9) voor offline-first synchronisatie en een aparte lichte REST API v1/v2 voor simpele taken. In 2024 is dit gereorganiseerd in één v1 REST API onder /api/v1 met 99 endpoints verdeeld over 17 tags: taken, projecten, secties, comments, labels, folders, herinneringen, backups, uploads, emails, workspaces, templates en activity-logs. De spec is OpenAPI 3.1 en documentatie wordt via developer.todoist.com gepubliceerd. OAuth 2.0 en persoonlijke API-tokens zijn beide ondersteund. Webhooks leveren realtime events bij taakwijzigingen.

API versies

API v1 Major release
1 september 2024

Gelanceerd onder api.todoist.com/api/v1 met 99 endpoints en OpenAPI 3.1-spec. Consolideert de oude Sync en REST API's.

Workspaces Major release
1 januari 2024

Workspace-endpoints toegevoegd voor team-edities met invitations, plan-details en user-management.

Quick Add
1 mei 2020

POST /tasks/quick toegevoegd voor natural-language-parsing van taken vanuit één tekstveld.

REST API v1 Major release
1 juni 2013

Eerste publieke REST API gelanceerd met basisfuncties voor projecten en taken.