Developers

Build integrations with TalonTodo: OAuth 2.0 sign-in, a versioned REST API for tasks, and an embeddable task list widget.

Login with TalonTodo

Register an OAuth application in the TalonTodo app under Settings, then send users through the authorization flow. You receive an authorization code and exchange it for access and refresh tokens.

  • Authorization and token endpoints under /api/oauth
  • Scopes: tasks:read, tasks:write, tasks:complete, profile:read

REST API v1

Call GET /api/v1/tasks, POST /api/v1/tasks, PATCH /api/v1/tasks/:id, POST /api/v1/tasks/:id/complete, and DELETE /api/v1/tasks/:id with a Bearer access token. User profile: GET /api/v1/user.

Embeddable widget

Use the hosted HTML widget at GET /widget/embed?token=... on your API base URL, or embed the in-app page at /widget/tasks?token=... on the TalonTodo web app. Tokens in URLs can leak via referrers; prefer short-lived tokens and HTTPS.

<iframe
  title="TalonTodo tasks"
  src="https://api.example.com/widget/embed?token=ACCESS_TOKEN"
  width="400"
  height="320"
/>

Documentation

Full guides are published on this site in the API docs section: OAuth, REST API reference, and the embeddable widget.