Public API reference
Read the REST API documentation for tasks, files, categories, groups, recurring exceptions, search, and AI extraction.
Open API reference ->Developer tools for Plaineo task and calendar workflows.
Use the Plaineo developer portal and REST API to connect apps, automations, smart home flows, and internal tools to your tasks, categories, files, groups, search, and AI task extraction.
Developer portal
Create and manage API keys, inspect examples, and test Plaineo API requests from the signed-in developer portal.
Open developer portal ->Home Assistant voice
Connect Plaineo to Home Assistant voice workflows so household commands can create tasks and shopping items.
View setup guide ->What the Plaineo API is for.
The public API exposes the same planning concepts people use inside Plaineo: tasks, dates, reminders, files, comments, categories, groups, search, and recurring task exceptions. It is meant for practical automations where a calendar or task list should be updated from another system.
Task and calendar automation
- Create tasks with dates, notes, reminders, subtasks, and attachments.
- Read calendar-ready task data for dashboards, scripts, and workflow tools.
- Update or soft-delete tasks while preserving shared-task permissions.
AI intake and file workflows
- Send text, images, files, or URLs for Plaineo AI task extraction.
- Upload files and thumbnails for tasks that need source context.
- Use search and compact category context for lightweight integrations.
Build with API keys and open documentation.
API keys are managed in the developer portal and sent with the X-API-Key HTTP header. The reference page is human-readable, while the OpenAPI JSON can be used for clients, tests, or internal tooling.
Reference docs
Browse routes for tasks, files, categories, groups, recurring exceptions, task search, AI extraction, and OpenAPI discovery.
Developer portal
Create keys, keep the full secret private, and return to the portal when you need to manage access for an integration.
Home Assistant voice
Use Plaineo with smart home voice routines so spoken household tasks, shopping items, and reminders land in the right place.
OpenAPI JSON
Use the machine-readable contract when generating clients or keeping automation code aligned with the published API.