# Delete a meeting

`DELETE https://api.coach-platform.com/api/public/meetings/{meetingId}`

Delete a meeting permanently.

- Resource: Meetings
- Authentication: API key in the `Authorization: Bearer cp_live_...` header
- HTML version: https://www.coach-platform.com/docs/api/reference/delete-meetings-meeting-id
- OpenAPI spec: https://www.coach-platform.com/openapi.json

## Path parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `meetingId` | string | Yes |   |

## Header parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `Idempotency-Key` | string | No | Optional. Send a unique key (e.g. a UUID) to make this POST safe to retry. The same key within 24h returns the original result instead of creating a duplicate. |

## Responses

| Status | Description |
|---|---|
| `200` OK |  |

### 200 OK

The OpenAPI spec does not describe a response body for this status.

## Examples

### cURL

```bash
curl --request DELETE \
  --url 'https://api.coach-platform.com/api/public/meetings/<meetingId>' \
  --header 'Authorization: Bearer cp_live_...'
```

### JavaScript (fetch)

```js
const response = await fetch('https://api.coach-platform.com/api/public/meetings/<meetingId>', {
  method: 'DELETE',
  headers: {
    Authorization: 'Bearer cp_live_...',
  },
});

const data = await response.json();
```

## Related endpoints

- [List meetings](https://www.coach-platform.com/docs/api/reference/get-meetings/index.md): `GET /api/public/meetings`. List meetings in a time window.
- [Schedule a meeting](https://www.coach-platform.com/docs/api/reference/post-meetings/index.md): `POST /api/public/meetings`. Schedule a meeting.
- [Get a meeting](https://www.coach-platform.com/docs/api/reference/get-meetings-meeting-id/index.md): `GET /api/public/meetings/{meetingId}`. Get a meeting by id.
- [Update a meeting](https://www.coach-platform.com/docs/api/reference/patch-meetings-meeting-id/index.md): `PATCH /api/public/meetings/{meetingId}`. Update a meeting (time, title, attendees, notes, status).
- Previous: [Update a meeting](https://www.coach-platform.com/docs/api/reference/patch-meetings-meeting-id/index.md): `PATCH /api/public/meetings/{meetingId}`. Update a meeting (time, title, attendees, notes, status).
- Next: [List forms](https://www.coach-platform.com/docs/api/reference/get-forms/index.md): `GET /api/public/forms`. List forms (questionnaires) created by the coach.