Skip to content
XOS Developers

calendarFeeds

Platform module · 5 operations

List calendar feed rows

GET/calendar-feeds

An iCalendar feed. The token is shown once, stored hashed and revocable. Returns a cursor page of calendar feed rows the caller may see. The default order is `created_at` ascending. Supports sparse fieldsets and the filter grammar.

Create a calendar feed

POST/calendar-feeds

Creates an iCalendar feed of the caller's schedule, optionally for one project, through `app.create_calendar_feed`. The token of the subscription URL is returned once. Requires `Idempotency-Key`; a replay returns the original response. A rule that refuses the request returns 422 with `refusal` and `reason`.

Get a calendar feed

GET/calendar-feeds/{id}

An iCalendar feed. The token is shown once, stored hashed and revocable. Returns one calendar feed with its `ETag`. A calendar feed the caller may not see returns 404.

Delete a calendar feed

DELETE/calendar-feeds/{id}

An iCalendar feed. The token is shown once, stored hashed and revocable. Soft-deletes the calendar feed: it moves to Trash and can be restored for its table's retention period.

Get a new link for a calendar feed

POST/calendar-feeds/{id}/rotate

Replaces the token of one of the caller's feeds (app.rotate_calendar_feed) and returns the new one once. The old subscription URL answers 404 at once; a revoked feed is not found. Requires `Idempotency-Key`; a replay returns the original response. A rule that refuses the request returns 422 with `refusal` and `reason`.