---
title: "Cancel one time and every booking in it; its guests are emailed. With guests: choose, each guest picks another time of the offering (or a refund) on their booking page within 7 days instead. On a time already called off, guests: refund cancels and refunds whoever is still picking; again, it changes nothing"
method: POST
path: "/sessions/{id}/cancel"
tags: ["sessions"]
---

# Cancel one time and every booking in it; its guests are emailed. With guests: choose, each guest picks another time of the offering (or a refund) on their booking page within 7 days instead. On a time already called off, guests: refund cancels and refunds whoever is still picking; again, it changes nothing

`POST /sessions/{id}/cancel`

## Request

- Base URL: `https://daybag.io/api/v1`
- URL: `https://daybag.io/api/v1/sessions/{id}/cancel`
- Auth: HTTP bearer

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `guests` 'refund' | 'choose': refund (default): cancel every booking, refunding what was paid online. choose: holds and a reseller's bookings are cancelled; each other booking stays confirmed with choose_by, the end of the 7th day in the org's time zone, while its guest picks another time of the offering (booking.moved) or cancels. Whoever hasn't picked by then is cancelled, refunding what they paid online
  - `note` string: A line in your words for the guests' email, such as why the time can't run

## Response `200`

Success

- object
  - `id` string, required
  - `org_id` string, required
  - `offering_id` string, required
  - `starts_at` string, required: ISO 8601 timestamp (UTC)
  - `ends_at` string, required: ISO 8601 timestamp (UTC)
  - `capacity` integer, nullable, required: Seats for this session; null means the class's capacity
  - `status` 'scheduled' | 'cancelled', required
  - `series_id` string, nullable: The calendar entry it's a time of; null when scheduled on its own
  - `occurs_on` string, nullable: Its entry's local date for it
  - `teacher` object, nullable: Who teaches it; null for nobody
    - `user_id` string, required
    - `name` string, required: Their name, or their email's local part until they set one
  - `created_at` string, required: ISO 8601 timestamp (UTC)

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/daybag/apis/daybooked-io-api.md) · [All operations](https://skmtc.dev/daybag/apis/daybooked-io-api/llms.txt) · [OpenAPI document](https://skmtc.dev/daybag/apis/daybooked-io-api/revisions/1f576dead370?raw)