Group sessions
A group session is one scheduled occurrence of a group event type with a limited number of seats. Create sessions with an API key; invitees see them on the public schedule and book a seat without one. A seat is an ordinary booking with a sessionId.
Pass repeatWeeks when creating to repeat weekly (up to 26 occurrences). Cancelling with scope: "following" cancels this session and every later one in its series. Cancelling a session cancels each seat and notifies the attendees.
GET /public/:handle/schedule
Upcoming group sessions with seats left. Auth: none.
Path parameters
| Field | Type | Required | Default / limits |
|---|---|---|---|
handle | string | yes | - |
Query parameters
| Field | Type | Required | Default / limits |
|---|---|---|---|
from | string (date) | string (date-time) | yes | - |
to | string (date) | string (date-time) | yes | - |
tz | string | no | min 1 chars |
eventType | string | no | 1–600 chars |
Response 200
Body
| Field | Type | Required | Default / limits |
|---|---|---|---|
host | object | yes | - |
host.handle | string | yes | - |
host.displayName | string | yes | - |
host.timezone | string | yes | - |
eventTypes | object[] | yes | - |
eventTypes[].slug | string | yes | - |
eventTypes[].title | string | yes | - |
sessions | object[] | yes | - |
sessions[].id | string (uuid) | yes | - |
sessions[].eventTypeSlug | string | yes | - |
sessions[].title | string | yes | - |
sessions[].description | string | yes | - |
sessions[].startAt | string (date-time) | yes | - |
sessions[].endAt | string (date-time) | yes | - |
sessions[].capacity | integer | yes | -9007199254740991–9007199254740991 |
sessions[].seatsLeft | integer | yes | -9007199254740991–9007199254740991 |
sessions[].locationKind | "url" | "phone" | "in_person" | "custom" | yes | - |
sessions[].locationValue | string | yes | - |
branding | boolean | yes | - |
Errors: invalid_request, not_found
curl -X GET "https://devalender.com/api/public/<handle>/schedule?from=2030-01-07&to=2030-01-07"POST /public/:handle/:slug/sessions/:sessionId/bookings
Book a seat in a group session. Auth: none.
Path parameters
| Field | Type | Required | Default / limits |
|---|---|---|---|
handle | string | yes | - |
slug | string | yes | - |
sessionId | string | yes | - |
Request body
| Field | Type | Required | Default / limits |
|---|---|---|---|
inviteeName | string | yes | 1–100 chars |
inviteeEmail | string (email) | yes | - |
inviteeTimezone | string | yes | min 1 chars |
Response 201
Body
| Field | Type | Required | Default / limits |
|---|---|---|---|
booking | object | yes | - |
booking.id | string (uuid) | yes | - |
booking.eventTypeId | string (uuid) | yes | - |
booking.hostId | string (uuid) | yes | - |
booking.inviteeName | string | yes | - |
booking.inviteeEmail | string (email) | yes | - |
booking.inviteeTimezone | string | yes | - |
booking.startAt | string (date-time) | yes | - |
booking.endAt | string (date-time) | yes | - |
booking.status | "confirmed" | "cancelled" | yes | - |
booking.cancelReason | string | null | yes | - |
booking.rescheduledFromId | string (uuid) | null | yes | - |
booking.sessionId | string (uuid) | no | - |
booking.createdAt | string (date-time) | yes | - |
manageToken | string | yes | - |
branding | boolean | yes | - |
demo | boolean | no | - |
Errors: invalid_request, not_found, session_full, already_booked, rate_limited
curl -X POST "https://devalender.com/api/public/<handle>/<slug>/sessions/<sessionId>/bookings" \
-H "Content-Type: application/json" \
-d '{"inviteeName":"string","inviteeEmail":"[email protected]","inviteeTimezone":"string"}'GET /sessions
List sessions. Auth: API key.
Query parameters
| Field | Type | Required | Default / limits |
|---|---|---|---|
from | string (date-time) | no | - |
to | string (date-time) | no | - |
eventTypeId | string (uuid) | no | - |
Response 200
Body (array of objects)
| Field | Type | Required | Default / limits |
|---|---|---|---|
id | string (uuid) | yes | - |
eventTypeId | string (uuid) | yes | - |
startAt | string (date-time) | yes | - |
endAt | string (date-time) | yes | - |
capacity | integer | yes | -9007199254740991–9007199254740991 |
seatsTaken | integer | yes | -9007199254740991–9007199254740991 |
status | "scheduled" | "cancelled" | yes | - |
seriesId | string (uuid) | null | yes | - |
Errors: invalid_request, unauthorized
curl -X GET "https://devalender.com/api/sessions" \
-H "Authorization: Bearer dvl_..."POST /sessions
Create a session, optionally repeating weekly. Auth: API key.
Request body
| Field | Type | Required | Default / limits |
|---|---|---|---|
eventTypeId | string (uuid) | yes | - |
startAt | string (date-time) | yes | - |
capacity | integer | no | 1–500 |
repeatWeeks | integer | no | 1–26 |
Response 201
Body (array of objects)
| Field | Type | Required | Default / limits |
|---|---|---|---|
id | string (uuid) | yes | - |
eventTypeId | string (uuid) | yes | - |
startAt | string (date-time) | yes | - |
endAt | string (date-time) | yes | - |
capacity | integer | yes | -9007199254740991–9007199254740991 |
seatsTaken | integer | yes | -9007199254740991–9007199254740991 |
status | "scheduled" | "cancelled" | yes | - |
seriesId | string (uuid) | null | yes | - |
Errors: invalid_request, not_group_event_type, session_in_past, not_found, unauthorized
curl -X POST "https://devalender.com/api/sessions" \
-H "Authorization: Bearer dvl_..." \
-H "Content-Type: application/json" \
-d '{"eventTypeId":"00000000-0000-4000-8000-000000000000","startAt":"2030-01-07T10:00:00Z"}'PATCH /sessions/:id
Move a session or change its capacity. Auth: API key.
Path parameters
| Field | Type | Required | Default / limits |
|---|---|---|---|
id | string | yes | - |
Request body
| Field | Type | Required | Default / limits |
|---|---|---|---|
startAt | string (date-time) | no | - |
capacity | integer | no | 1–500 |
Response 200
Body
| Field | Type | Required | Default / limits |
|---|---|---|---|
id | string (uuid) | yes | - |
eventTypeId | string (uuid) | yes | - |
startAt | string (date-time) | yes | - |
endAt | string (date-time) | yes | - |
capacity | integer | yes | -9007199254740991–9007199254740991 |
seatsTaken | integer | yes | -9007199254740991–9007199254740991 |
status | "scheduled" | "cancelled" | yes | - |
seriesId | string (uuid) | null | yes | - |
Errors: invalid_request, session_not_active, not_found, unauthorized
curl -X PATCH "https://devalender.com/api/sessions/<id>" \
-H "Authorization: Bearer dvl_..." \
-H "Content-Type: application/json" \
-d '{"startAt":"2030-01-07T10:00:00Z"}'POST /sessions/:id/cancel
Cancel one session or this and all following. Auth: API key.
Path parameters
| Field | Type | Required | Default / limits |
|---|---|---|---|
id | string | yes | - |
Request body
| Field | Type | Required | Default / limits |
|---|---|---|---|
scope | "one" | "following" | no | default "one" |
reason | string | no | max 500 chars |
Response 200
Body (array of objects)
| Field | Type | Required | Default / limits |
|---|---|---|---|
id | string (uuid) | yes | - |
eventTypeId | string (uuid) | yes | - |
startAt | string (date-time) | yes | - |
endAt | string (date-time) | yes | - |
capacity | integer | yes | -9007199254740991–9007199254740991 |
seatsTaken | integer | yes | -9007199254740991–9007199254740991 |
status | "scheduled" | "cancelled" | yes | - |
seriesId | string (uuid) | null | yes | - |
Errors: invalid_request, session_not_active, not_found, unauthorized
curl -X POST "https://devalender.com/api/sessions/<id>/cancel" \
-H "Authorization: Bearer dvl_..." \
-H "Content-Type: application/json" \
-d '{"scope":"one"}'GET /sessions/:id/attendees
Bookings holding a seat in a session. Auth: API key.
Path parameters
| Field | Type | Required | Default / limits |
|---|---|---|---|
id | string | yes | - |
Response 200
Body (array of objects)
| Field | Type | Required | Default / limits |
|---|---|---|---|
id | string (uuid) | yes | - |
eventTypeId | string (uuid) | yes | - |
hostId | string (uuid) | yes | - |
inviteeName | string | yes | - |
inviteeEmail | string (email) | yes | - |
inviteeTimezone | string | yes | - |
startAt | string (date-time) | yes | - |
endAt | string (date-time) | yes | - |
status | "confirmed" | "cancelled" | yes | - |
cancelReason | string | null | yes | - |
rescheduledFromId | string (uuid) | null | yes | - |
sessionId | string (uuid) | no | - |
createdAt | string (date-time) | yes | - |
Errors: not_found, unauthorized
curl -X GET "https://devalender.com/api/sessions/<id>/attendees" \
-H "Authorization: Bearer dvl_..."