---
title: "Update a hold"
method: POST
path: "/v1/holds/{hold_id}"
tags: ["Holds"]
---

# Update a hold

`POST /v1/holds/{hold_id}`

Updates an existing hold

## Path parameters

- `hold_id` string, required

## Response `200`

Successfully updated the hold

- Hold
  - `object` string
  - `id` string — A unque identifier for the hold
  - `created_at` object
    - `date` string — ISO-8601 date for the created timestamp of the hold
    - `formatted` string — A formatted date string for the created timestamp of the hold
    - `iso` string — ISO-8601 date and time for the created timestamp of the hold
    - `time` string — Time of the created timestamp of the hold
    - `timezone` string — Timezone offset for the created timestamp of the hold
    - `unix` integer — Unix timestamp for when the hold was created
  - `event_id` string — ID of the event that the hold belongs to
  - `note` string — A note for the hold
  - `total_on_hold` integer — Total number of tickets on hold
  - `updated_at` object
    - `date` string — ISO-8601 date for the updated timestamp of the hold
    - `formatted` string — A formatted date string for the updated timestamp of the hold
    - `iso` string — ISO-8601 date and time for the updated timestamp of the hold
    - `time` string — Time of the updated timestamp of the hold
    - `timezone` string — Timezone offset for the updated timestamp of the hold
    - `unix` integer — Unix timestamp for when the hold was updated
  - `quantities` object[] — Hold quantities for each of the associated ticket type ID
    - `ticket_type_id` string — Ticket type ID
    - `quantity` integer — Number of held tickets of this type

## Other responses

- `default` — Error schema

---

[API](https://skmtc.net/tickettailor/apis/ticket-tailor-api.md) · [All operations](https://skmtc.net/tickettailor/apis/ticket-tailor-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tickettailor/ticket-tailor-api/revisions/7b222e8ec91c/schema)