---
title: "Move one time nobody has booked (starts_at and ends_at together), or change who teaches it (teacher); its calendar entry's other times stay. A booked one can't move, only be cancelled, but its teacher can change."
method: PATCH
path: "/sessions/{id}"
tags: ["sessions"]
---

# Move one time nobody has booked (starts_at and ends_at together), or change who teaches it (teacher); its calendar entry's other times stay. A booked one can't move, only be cancelled, but its teacher can change.

`PATCH /sessions/{id}`

## Request

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

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `starts_at` string: ISO 8601 instant, e.g. 2026-10-03T15:00:00Z
  - `ends_at` string: ISO 8601 instant, e.g. 2026-10-03T15:00:00Z
  - `teacher` string, uuid, nullable: Who teaches it: a member's user id (Settings → Team); null for nobody. Anyone not on your team answers 400 not_a_member

## 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)