Skip to content

Create a calendar feed. The response holds the address with its token; it is never shown again.

POST
/on_call/feed_tokens
curl --request POST \
--url https://api.siteqwality.com/on_call/feed_tokens \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "schedule_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "user_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" }'
Media type application/json

Ask for a calendar feed. Without schedule_id the feed is the user’s own shifts on every schedule; with it, every shift of that schedule.

object
schedule_id
string | null format: uuid
user_id

Whose feed it is. Defaults to the signed-in user; an API key must name one.

string | null format: uuid
Example generated
{
"schedule_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"user_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
}

Feed created; url holds the token and is shown once

Media type application/json

A new feed. url holds the token and is shown only in this response.

object
id
required
string format: uuid
user_id
required
string format: uuid
schedule_id
string | null format: uuid
created_at
required
string format: date-time
revoked_at
string | null format: date-time
last_used_at
string | null format: date-time
url
required

The https address to subscribe to.

string
webcal_url
required

The same address for calendar apps that open webcal:// links.

string
Example generated
{
"id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"user_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"schedule_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"created_at": "2026-04-15T12:00:00Z",
"revoked_at": "2026-04-15T12:00:00Z",
"last_used_at": "2026-04-15T12:00:00Z",
"url": "example",
"webcal_url": "example"
}

An API key named no user_id

Missing or invalid authentication

User or schedule not found

Internal server error