# ovok_sdk.resources.video_calls

Canonical page: https://docs.ovok.com/python-sdk/reference/resources/video_calls

LiveKit video calls: appointments, access and email notices.

## VideoCallAppointmentsResource [#videocallappointmentsresource]

```python
VideoCallAppointmentsResource(http: HttpClient)
```

Video-call appointments; access it as `ovok.video_calls.appointments`.

**Parameters**

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `http` | `HttpClient` |  | The HTTP client scoped to the LiveKit routes. |

### list() [#list]

```python
list(params: QueryParams | None = None) -> list[Resource]
```

List video-call appointments.

**Parameters**

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `params` | `QueryParams \| None` | `None` | Optional query parameters passed to the API. |

**Returns**

- `list[Resource]`: The appointments.

### create() [#create]

```python
create(body: Resource) -> Resource
```

Create a video-call appointment.

**Parameters**

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `body` | `Resource` |  | The appointment as the API takes it. |

**Returns**

- `Resource`: The created appointment.

### update() [#update]

```python
update(appointment_id: str, body: Resource) -> Resource
```

Replace a video-call appointment.

**Parameters**

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `appointment_id` | `str` |  | The appointment ID. |
| `body` | `Resource` |  | The new appointment. |

**Returns**

- `Resource`: The updated appointment.

## VideoCallAccessResource [#videocallaccessresource]

```python
VideoCallAccessResource(http: HttpClient)
```

Access to a video call's room; access it as `ovok.video_calls.access`.

**Parameters**

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `http` | `HttpClient` |  | The HTTP client scoped to the LiveKit routes. |

### permission() [#permission]

```python
permission(appointment_id: str) -> Resource
```

Check whether the signed-in user may join an appointment's call.

**Parameters**

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `appointment_id` | `str` |  | The appointment ID. |

**Returns**

- `Resource`: The access permission.

### create_guest() [#create_guest]

```python
create_guest(appointment_id: str, body: Resource) -> Resource
```

Create guest access to an appointment's call.

**Parameters**

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `appointment_id` | `str` |  | The appointment ID. |
| `body` | `Resource` |  | The guest as the API takes it. |

**Returns**

- `Resource`: The guest access, including its token.

### create_user() [#create_user]

```python
create_user(appointment_id: str) -> Resource
```

Create access for the signed-in user to an appointment's call.

**Parameters**

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `appointment_id` | `str` |  | The appointment ID. |

**Returns**

- `Resource`: The user access, including its token.

## VideoCallEmailsResource [#videocallemailsresource]

```python
VideoCallEmailsResource(http: HttpClient)
```

Video-call email notices; access it as `ovok.video_calls.emails`.

**Parameters**

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `http` | `HttpClient` |  | The HTTP client scoped to the LiveKit routes. |

### invite() [#invite]

```python
invite(body: Resource) -> Resource
```

Email an invitation to a call.

**Parameters**

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `body` | `Resource` |  | The invitation as the API takes it. |

**Returns**

- `Resource`: The API's response.

### update() [#update-1]

```python
update(body: Resource) -> Resource
```

Email a notice that a call changed.

**Parameters**

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `body` | `Resource` |  | The notice as the API takes it. |

**Returns**

- `Resource`: The API's response.

### cancel() [#cancel]

```python
cancel(body: Resource) -> Resource
```

Email a notice that a call was cancelled.

**Parameters**

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `body` | `Resource` |  | The notice as the API takes it. |

**Returns**

- `Resource`: The API's response.

## VideoCallsResource [#videocallsresource]

```python
VideoCallsResource(http: HttpClient)
```

LiveKit video calls: appointments, room access and email notices.

Created by `Ovok`; access it as `ovok.video_calls`.

### notify_active() [#notify_active]

```python
notify_active(appointment_id: str) -> Resource
```

Notify the participants that an appointment's call is active.

**Parameters**

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `appointment_id` | `str` |  | The appointment ID. |

**Returns**

- `Resource`: The API's response.