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 its responses. However, updating this data is allowed as well as creating new entities.
To export your data out of the app, use our data export feature 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.
That said, Lunatask is an end-to-end encrypted app, and as such, Lunatask servers don’t have access to your data – therefore, they naturally can’t share it with other tools.
This is a common limitation of encrypted apps – encryption and sharing don’t usually 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 other systems via our servers, APIs, or 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. |