{"id":"tasks.external-api","app":"tasks","title":"Tasks API tokens and CRUD integration","summary":"Read, create and update tasks from an external server.","url":"https://www.simultem-apps.com/wiki/tasks#external-api","apiUrl":"https://www.simultem-apps.com/api/wiki/v1/articles/tasks.external-api","resourceUri":"wiki://tasks/external-api","revision":"2026-11-02.1","lastReviewedAt":"2026-11-02","keywords":["API tokens","bearer","GET","POST","PATCH","includeFull","rate limit"],"sections":[{"title":"Create credentials","steps":["Open Tasks API tokens using an authorized account context.","Name the integration, create the token and copy it immediately into a server-side secret manager.","Review active/revoked tokens and revoke unused credentials."],"notes":[]},{"title":"Use the endpoint shown by Tasks","steps":["Use the running Tasks app’s endpoint ending in /api/tasks/api and Authorization: Bearer YOUR_TASKS_API_TOKEN.","GET supports id, ids, externalId, bookingId, reservationId, propertyId, status, from, to, includeCanceled and includeFull filters.","POST accepts task or tasks, up to 500 tasks per request.","PATCH uses id and patch for a supported task update.","Inspect the JSON ok field. Respect 120 reads/minute and 30 writes/minute per token and handle 429 with Retry-After/RateLimit headers. Up to 10 active tokens are supported per account."],"notes":[],"example":"{\"id\":\"TASK_ID\",\"patch\":{\"status\":\"Completed\",\"isCompleted\":true}}"}],"text":"# Tasks: Tasks API tokens and CRUD integration\n\nRead, create and update tasks from an external server.\n\n## Create credentials\n\n1. Open Tasks API tokens using an authorized account context.\n\n2. Name the integration, create the token and copy it immediately into a server-side secret manager.\n\n3. Review active/revoked tokens and revoke unused credentials.\n\n## Use the endpoint shown by Tasks\n\n1. Use the running Tasks app’s endpoint ending in /api/tasks/api and Authorization: Bearer YOUR_TASKS_API_TOKEN.\n\n2. GET supports id, ids, externalId, bookingId, reservationId, propertyId, status, from, to, includeCanceled and includeFull filters.\n\n3. POST accepts task or tasks, up to 500 tasks per request.\n\n4. PATCH uses id and patch for a supported task update.\n\n5. Inspect the JSON ok field. Respect 120 reads/minute and 30 writes/minute per token and handle 429 with Retry-After/RateLimit headers. Up to 10 active tokens are supported per account.\n\nExample:\n\n```text\n\n{\"id\":\"TASK_ID\",\"patch\":{\"status\":\"Completed\",\"isCompleted\":true}}\n\n```","related":[{"id":"tasks.effects","app":"tasks","title":"Completion effects, maintenance and delivery review","summary":"Control the downstream effects of completing, reopening or editing tasks.","url":"https://www.simultem-apps.com/wiki/tasks#effects","apiUrl":"https://www.simultem-apps.com/api/wiki/v1/articles/tasks.effects","resourceUri":"wiki://tasks/effects","revision":"2026-11-02.1","lastReviewedAt":"2026-11-02"},{"id":"platform.wiki-api","app":"platform","title":"Connect an external AI tool to the wiki API","summary":"Discover apps, search articles and fetch authoritative instructions using a public read-only API.","url":"https://www.simultem-apps.com/wiki/platform#wiki-api","apiUrl":"https://www.simultem-apps.com/api/wiki/v1/articles/platform.wiki-api","resourceUri":"wiki://platform/wiki-api","revision":"2026-11-02.1","lastReviewedAt":"2026-11-02"}]}