---
title: "Edit a Huddle: join link, reschedule, or cancel"
method: PATCH
path: "/api/rewards/admin/huddles/{id}"
tags: ["Rewards (admin)"]
---

# Edit a Huddle: join link, reschedule, or cancel

`PATCH /api/rewards/admin/huddles/{id}`

## Request

- Base URL: `https://api.rewritelifestyle.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.rewritelifestyle.ai/api/rewards/admin/huddles/{id}`
- Auth: HTTP bearer

Its calendar event follows every change (BE-5.1). join_url gives it its own link (null: none; omitted leaves it; never served to a user who isn't invited); use_standing_link: true puts it back on the standing link. scheduled_at reschedules (the snapshot moves too if it has not run). cancelled: true cancels the Huddle and its event; final. Once the invite list is taken, invitees get a push when it moves or is cancelled.

## Path parameters

- `id` number, required

## Request body

- UpdateHuddleDto
  - `join_url` object, nullable: Give this Huddle its own https link (it stops following the standing link); null leaves it with none, omitted leaves it as is. Never served to a user who is not invited.
  - `use_standing_link` boolean: true puts the Huddle back on the standing link. Not with join_url.
  - `scheduled_at` string: Reschedule (BE-5.1). The calendar event moves with it.
  - `cancelled` boolean: true cancels the Huddle and its calendar event (BE-5.1). Final.
  - `duration_minutes` number: How long the call runs, in minutes (15–240). Default 60. (G27)
  - `host_coach_id` object, nullable: Change the hosting coach; null clears. (G27)

## Response `200`

## Changes

- **2026-10-29** `9c1ca2f411f1`: 1 info
  - added the new optional request property `use_standing_link`
- **2026-10-27** `5231b7914987`: 5 info
  - added the new optional request property `cancelled`
  - added the new optional request property `duration_minutes`
  - added the new optional request property `host_coach_id`
  - added the new optional request property `scheduled_at`
  - …1 more
- **2026-09-12** `0d5ef02a4fbe`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rewritelifestyle/apis/rewrite-lifestyle-api/changes/api/rewards/admin/huddles/:id/patch.md)

---

[API](https://skmtc.dev/rewritelifestyle/apis/rewrite-lifestyle-api.md) - [All operations](https://skmtc.dev/rewritelifestyle/apis/rewrite-lifestyle-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rewritelifestyle/apis/rewrite-lifestyle-api/revisions/28695827f27a?raw)