Authentication

The Todomino REST API lives at https://app.todomino.eu/api and uses personal access tokens (PATs) for programmatic access — integrations, scripts, and automations.

Creating a token

1. Open Settings → General → API tokens in Todomino.
2. Name the token after the integration it is for (for example home-automation), so you can revoke it independently later.
3. Copy the token immediately — it starts with tdm_ and is shown once.

Using the token

Send the token as a bearer token on every request:

curl -H "Authorization: Bearer tdm_..." \
  https://app.todomino.eu/api/workspaces

Tokens have the same permissions as your account: every workspace you are a member of, with your role in each.

Good to know

• Revocation: delete a token in the settings at any time; it stops working immediately.
• One token per integration keeps a leak or revocation from affecting everything else.
• Common error responses: 401 (missing or invalid token), 403 (valid account but insufficient role), 404 (also returned for workspaces you are not a member of), 409 (conflict, e.g. concurrent edit), 413 (workspace storage limit reached).