# Remove a guest

`POST /onair.guest.remove`

## Description

Removes a guest from an On-Air event.

**Access:** Organization and Personal.

**Required scope:** `onair:write`

---

**OpenAPI Spec:** [onair.json](https://developer.ro.am/onair.json)

## Authentication

```
Authorization: Bearer YOUR_API_KEY
```

## Request Body

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `id` | string | Yes | Identifier of the guest to remove. |

### Example Request

```json
{
  "id": "gst_xyz789"
}
```

## Responses

### 204 - Guest removed successfully.

### 400 - Bad request.

### 401 - Presented invalid authentication credentials.

### 500 - An internal error occurred.

---

*Machine-readable API documentation.*
*Full documentation: https://developer.ro.am/docs/onair-api/onair-guest-remove*