---
title: "Update an extra"
method: PUT
path: "/api/v1/extras/{id}"
tags: ["Extras"]
---

# Update an extra

`PUT /api/v1/extras/{id}`

## Request

- Base URL: `https://api.checkcherry.com`
- URL: `https://api.checkcherry.com/api/v1/extras/{id}`
- Auth: none declared. Required headers: `Api-Key`

Updates an existing extra with the provided fields. Only fields included in the request body are modified. Omitted fields remain unchanged.

Use this to rename an extra, change its pricing, toggle widget visibility, or archive it (set `status` to `Archived`). To move an extra to a different group, use the move endpoint.

**Required permission:** `offerings_write`

## Path parameters

- `id` integer, required

## Headers

- `Api-Key` string, required

## Request body

- object
  - `name` string: The name of the extra (e.g., "Gold Sequin Backdrop")
  - `description` string: Customer-facing description of the extra
  - `status` 'Active' | 'Archived': Whether the extra is active or archived
  - `price_method` 'flat_rate' | 'hourly' | 'daily': How the extra is priced
  - `price` number: Flat-rate price in dollars (used when price_method is flat_rate)
  - `hourly_price` number: Per-hour price in dollars (used when price_method is hourly)
  - `daily_price` number: Per-day price in dollars (used when price_method is daily)
  - `taxable` boolean: Whether the extra is taxable
  - `maximum_quantity` integer: Maximum quantity a customer can book (must be >= 1)
  - `multiply_by_number_of_units` boolean: Multiply the price by the quantity booked
  - `visible_on_widget` boolean: Whether the extra is shown on the booking widget
  - `adds_minutes_to_event_length` boolean: Whether booking this extra extends the event length
  - `minutes_to_be_added_to_event_length` integer: Minutes added to the event length when adds_minutes_to_event_length is true
  - `requires_lead_time` boolean: Whether the extra requires advance lead time to book
  - `lead_time_days` integer: Required lead time in days (when requires_lead_time is true)
  - `video_url` string: YouTube URL for a demo video of the extra

## Response `200`

extra updated

---

[API](https://skmtc.dev/checkcherry/apis/check-cherry-business-api.md) · [All operations](https://skmtc.dev/checkcherry/apis/check-cherry-business-api/llms.txt) · [OpenAPI document](https://skmtc.dev/checkcherry/apis/check-cherry-business-api/revisions/84a9aabdf519?raw)