---
title: "Give up a booking that is not booked yet"
method: POST
path: "/api/public/dental-network/tools/abandon_xona_booking"
---

# Give up a booking that is not booked yet

`POST /api/public/dental-network/tools/abandon_xona_booking`

## Request

- Base URL: `https://book.xonark.com`
- URL: `https://book.xonark.com/api/public/dental-network/tools/abandon_xona_booking`
- Auth: none required

Release the held time and drop the patient's details when the patient no longer wants it, at any step before it is booked. It never cancels a booked appointment. Calling again returns the same result.

## Request body

- object
  - `action_id` string, required

## Response `200`

Give up a booking that is not booked yet

- object
  - `action_id` string, required
  - `appointment_start` string, date-time
  - `appointment_start_local` string
  - `booking_steps` object[]
    - `patient_does` string
    - `patient_provides` string[]
    - `status` 'done' | 'waiting_for_patient' | 'not_started', required
    - `step` integer, required
    - `tool` string
    - `xona_sends` object
      - `channel` string, required
      - `contains` string
      - `link_expires_at` string, date-time
      - `to` string
  - `booking_url` string
  - `confirmation_sms` string
  - `consent_version` string
  - `continue_url` string
  - `link_expires_at` string, date-time
  - `next_step` string, required
  - `outcome` string, required
  - `practice` object, required
    - `name` string, required
    - `slug` string, required
  - `reason` string

## Other responses

- `400`: Invalid request or action state
- `403`: Public write is disabled, or not a member of the claiming account
- `404`: Dental resource not found
- `410`: Dental action expired
- `413`: Request body too large
- `429`: Rate limit exceeded
- `502`: Clinic booking provider is unavailable
- `503`: Gateway temporarily unavailable
- `504`: Clinic booking provider timed out

---

[API](https://skmtc.dev/xonark/apis/xona-dental-gateway-public-api.md) · [All operations](https://skmtc.dev/xonark/apis/xona-dental-gateway-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/xonark/apis/xona-dental-gateway-public-api/revisions/886252359184?raw)