Welcome to Lunatask API 👋
You can use our API to manage data in your Lunatask account, build powerful automations, integrations with your favorite tools, or perform one-time data imports.
Encryption​
All text entered into Lunatask is end-to-end encrypted and never transmitted out of our apps or stored on our servers in a plain readable form. The only way to decrypt such data is by using your master password inside our client apps. Access tokens don’t replace your master password.
Lunatask API doesn’t provide a way to read end-to-end encrypted data. Names of entities, notes, and other encrypted data can’t be read using the API, therefore the API doesn’t return such data in responses. However, updating this data is allowed as well as creating new entities. To get this data out of the app, use data export instead.
Your data gets encrypted as soon as it reaches our servers and we keep no logs. You can learn more about our approach to encryption and privacy here.
Webhooks​
We often get asked about webhooks and allowing sharing or syncing of data with other tools this way.
Lunatask is an encrypted app, and as such, Lunatask servers don’t have access to your data – therefore, they can’t share it with other tools.
This is a common limitation of encrypted apps: encryption and sharing don’t always work well together. On one hand, you want your data to be secure and accessible only to you; on the other, you want to share it with multiple systems via our servers, APIs, and webhooks. That’s where the inherent conflict comes in.
Errors​
The API uses the following error codes:
| Code | Meaning |
|---|---|
| 400 | Bad Request -- Provided parameters are invalid, malformed, or missing. |
| 401 | Unauthorized -- Your access token is missing, is wrong, or was revoked. |
| 402 | Limit Reached on Free Plan -- A subscription is required to continue. |
| 404 | Not Found -- The specified entity couldn’t be found. |
| 422 | Unprocessable Entity -- The provided entity isn’t valid. Check what data you’re sending. |
| 500 | Internal Server Error -- We encountered a problem processing your request and have been notified. Please, try again later. If the problem persists, please contact us. |
| 503 | Service Unavailable -- We’re temporarily offline for maintenance. Please, try again later. |
| 524 | Request Timed Out -- Please, try again. |