Skip to content
WorkRoad home
REST API

List calendar feeds

GET
/calendar-feeds

The user's calendar feed addresses, oldest first, without the addresses themselves: those are shown only when issued. A user has at most 10. Never paged. Feeds are created and rotated in the app, under Settings → Calendar feeds.

Required scopes: settings:view and schedule:view

Authorization

headerAuthorizationBearer <token>

Response Body

OK

application/json
  1. response
data*array<>
Example Request
curl -X GET 'https://workroad.app/api/v1/calendar-feeds' \  -H 'Authorization: Bearer $WORKROAD_API_KEY'
Example Response
{  "data": [    {      "id": "kq0V3mJ8yQe7Lw2nR5tXcB1dF4gH6jK9",      "schedules": [        {          "id": "8c2b5a1e-7d4f-4e3a-9b6c-1f0e2d3c4b5a",          "name": "Year 12 timetable"        }      ],      "createdAt": "2026-01-15T09:30:00.000Z",      "lastUsedAt": "2026-02-01T12:00:00.000Z"    }  ]}

Delete a calendar feed DELETE

The address stops working at once. Calendar apps subscribed to it keep the events they already have but get no updates.

Apply copilot actions POST

Runs the actions an assistant reply proposed and returns a receipt for each.