Welcome to Lunatask API 👋
You can use our API to manage data in your Lunatask account, build 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 do not replace your master password.
Lunatask API does not provide a way to read end-to-end encrypted data. Names of entities, notes, and other encrypted data cannot be read using the API, therefore the API does not 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 do not have access to your data – therefore, they cannot 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 could not be found. |
| 422 | Unprocessable Entity -- The provided entity is not valid. Check what data you are 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. |