# \CallsApi
All URIs are relative to *https://api.spatio.app*
[**create_call**](CallsApi.md#create_call) | **POST** /v1/calls | Start a new call.
[**create_meeting_room**](CallsApi.md#create_meeting_room) | **POST** /v1/calls/rooms | Create a persistent meeting room.
[**delete_call_recording**](CallsApi.md#delete_call_recording) | **DELETE** /v1/calls/recordings/{recordingId} | Delete a recording.
[**end_call**](CallsApi.md#end_call) | **POST** /v1/calls/{id}/end | End a call (host only).
[**get_bandwidth_history**](CallsApi.md#get_bandwidth_history) | **GET** /v1/calls/bandwidth/history | Time-series bandwidth metrics.
[**get_bandwidth_summary**](CallsApi.md#get_bandwidth_summary) | **GET** /v1/calls/bandwidth/summary | Aggregate bandwidth metrics.
[**get_call**](CallsApi.md#get_call) | **GET** /v1/calls/{id} | Fetch a call.
[**get_meeting_room**](CallsApi.md#get_meeting_room) | **GET** /v1/calls/rooms/{id} | Fetch a meeting room.
[**join_call**](CallsApi.md#join_call) | **POST** /v1/calls/{id}/join | Join a call.
[**leave_call**](CallsApi.md#leave_call) | **POST** /v1/calls/{id}/leave | Leave a call.
[**list_active_calls**](CallsApi.md#list_active_calls) | **GET** /v1/calls | List active calls.
[**list_call_recordings**](CallsApi.md#list_call_recordings) | **GET** /v1/calls/{id}/recordings | List recordings for a call.
[**start_call_recording**](CallsApi.md#start_call_recording) | **POST** /v1/calls/{id}/recordings/start | Start a recording (host only).
[**stop_call_recording**](CallsApi.md#stop_call_recording) | **POST** /v1/calls/{id}/recordings/{recordingId}/stop | Stop an in-progress recording.
[**update_call_participant_state**](CallsApi.md#update_call_participant_state) | **PATCH** /v1/calls/{id}/participant | Toggle participant audio/video/screen-share state.
[**workspace_create_call**](CallsApi.md#workspace_create_call) | **POST** /v1/organizations/{org}/workspaces/{workspace}/calls |
[**workspace_create_meeting_room**](CallsApi.md#workspace_create_meeting_room) | **POST** /v1/organizations/{org}/workspaces/{workspace}/calls/rooms |
[**workspace_delete_call_recording**](CallsApi.md#workspace_delete_call_recording) | **DELETE** /v1/organizations/{org}/workspaces/{workspace}/calls/recordings/{recordingId} |
[**workspace_end_call**](CallsApi.md#workspace_end_call) | **POST** /v1/organizations/{org}/workspaces/{workspace}/calls/{id}/end |
[**workspace_get_bandwidth_history**](CallsApi.md#workspace_get_bandwidth_history) | **GET** /v1/organizations/{org}/workspaces/{workspace}/calls/bandwidth/history |
[**workspace_get_bandwidth_summary**](CallsApi.md#workspace_get_bandwidth_summary) | **GET** /v1/organizations/{org}/workspaces/{workspace}/calls/bandwidth/summary |
[**workspace_get_call**](CallsApi.md#workspace_get_call) | **GET** /v1/organizations/{org}/workspaces/{workspace}/calls/{id} |
[**workspace_get_meeting_room**](CallsApi.md#workspace_get_meeting_room) | **GET** /v1/organizations/{org}/workspaces/{workspace}/calls/rooms/{id} |
[**workspace_join_call**](CallsApi.md#workspace_join_call) | **POST** /v1/organizations/{org}/workspaces/{workspace}/calls/{id}/join |
[**workspace_leave_call**](CallsApi.md#workspace_leave_call) | **POST** /v1/organizations/{org}/workspaces/{workspace}/calls/{id}/leave |
[**workspace_list_active_calls**](CallsApi.md#workspace_list_active_calls) | **GET** /v1/organizations/{org}/workspaces/{workspace}/calls |
[**workspace_list_call_recordings**](CallsApi.md#workspace_list_call_recordings) | **GET** /v1/organizations/{org}/workspaces/{workspace}/calls/{id}/recordings |
[**workspace_start_call_recording**](CallsApi.md#workspace_start_call_recording) | **POST** /v1/organizations/{org}/workspaces/{workspace}/calls/{id}/recordings/start |
[**workspace_stop_call_recording**](CallsApi.md#workspace_stop_call_recording) | **POST** /v1/organizations/{org}/workspaces/{workspace}/calls/{id}/recordings/{recordingId}/stop |
[**workspace_update_call_participant**](CallsApi.md#workspace_update_call_participant) | **PATCH** /v1/organizations/{org}/workspaces/{workspace}/calls/{id}/participant |
## create_call
> models::SpatioCall create_call(create_call_request)
Start a new call.
### Parameters
**create_call_request** | Option<[**CreateCallRequest**](CreateCallRequest.md)> | | |
### Return type
[**models::SpatioCall**](SpatioCall.md)
### Authorization
[bearerAuth](../README.md#bearerAuth)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## create_meeting_room
> models::MeetingRoom create_meeting_room(create_meeting_room_request)
Create a persistent meeting room.
### Parameters
**create_meeting_room_request** | [**CreateMeetingRoomRequest**](CreateMeetingRoomRequest.md) | | [required] |
### Return type
[**models::MeetingRoom**](MeetingRoom.md)
### Authorization
[bearerAuth](../README.md#bearerAuth)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## delete_call_recording
> delete_call_recording(recording_id)
Delete a recording.
### Parameters
**recording_id** | **String** | | [required] |
### Return type
(empty response body)
### Authorization
[bearerAuth](../README.md#bearerAuth)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## end_call
> end_call(id)
End a call (host only).
### Parameters
**id** | **String** | | [required] |
### Return type
(empty response body)
### Authorization
[bearerAuth](../README.md#bearerAuth)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## get_bandwidth_history
> std::collections::HashMap<String, serde_json::Value> get_bandwidth_history()
Time-series bandwidth metrics.
### Parameters
This endpoint does not need any parameter.
### Return type
[**std::collections::HashMap<String, serde_json::Value>**](serde_json::Value.md)
### Authorization
[bearerAuth](../README.md#bearerAuth)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## get_bandwidth_summary
> std::collections::HashMap<String, serde_json::Value> get_bandwidth_summary()
Aggregate bandwidth metrics.
### Parameters
This endpoint does not need any parameter.
### Return type
[**std::collections::HashMap<String, serde_json::Value>**](serde_json::Value.md)
### Authorization
[bearerAuth](../README.md#bearerAuth)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## get_call
> models::SpatioCall get_call(id)
Fetch a call.
### Parameters
**id** | **String** | | [required] |
### Return type
[**models::SpatioCall**](SpatioCall.md)
### Authorization
[bearerAuth](../README.md#bearerAuth)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## get_meeting_room
> models::MeetingRoom get_meeting_room(id)
Fetch a meeting room.
### Parameters
**id** | **String** | | [required] |
### Return type
[**models::MeetingRoom**](MeetingRoom.md)
### Authorization
[bearerAuth](../README.md#bearerAuth)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## join_call
> std::collections::HashMap<String, serde_json::Value> join_call(id)
Join a call.
### Parameters
**id** | **String** | | [required] |
### Return type
[**std::collections::HashMap<String, serde_json::Value>**](serde_json::Value.md)
### Authorization
[bearerAuth](../README.md#bearerAuth)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## leave_call
> leave_call(id)
Leave a call.
### Parameters
**id** | **String** | | [required] |
### Return type
(empty response body)
### Authorization
[bearerAuth](../README.md#bearerAuth)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## list_active_calls
> models::CallListResponse list_active_calls()
List active calls.
### Parameters
This endpoint does not need any parameter.
### Return type
[**models::CallListResponse**](CallListResponse.md)
### Authorization
[bearerAuth](../README.md#bearerAuth)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## list_call_recordings
> models::CallRecordingListResponse list_call_recordings(id)
List recordings for a call.
### Parameters
**id** | **String** | | [required] |
### Return type
[**models::CallRecordingListResponse**](CallRecordingListResponse.md)
### Authorization
[bearerAuth](../README.md#bearerAuth)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## start_call_recording
> models::CallRecording start_call_recording(id)
Start a recording (host only).
### Parameters
**id** | **String** | | [required] |
### Return type
[**models::CallRecording**](CallRecording.md)
### Authorization
[bearerAuth](../README.md#bearerAuth)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## stop_call_recording
> models::CallRecording stop_call_recording(id, recording_id)
Stop an in-progress recording.
### Parameters
**id** | **String** | | [required] |
**recording_id** | **String** | | [required] |
### Return type
[**models::CallRecording**](CallRecording.md)
### Authorization
[bearerAuth](../README.md#bearerAuth)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## update_call_participant_state
> std::collections::HashMap<String, serde_json::Value> update_call_participant_state(id, update_participant_state_request)
Toggle participant audio/video/screen-share state.
### Parameters
**id** | **String** | | [required] |
**update_participant_state_request** | [**UpdateParticipantStateRequest**](UpdateParticipantStateRequest.md) | | [required] |
### Return type
[**std::collections::HashMap<String, serde_json::Value>**](serde_json::Value.md)
### Authorization
[bearerAuth](../README.md#bearerAuth)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## workspace_create_call
> std::collections::HashMap<String, serde_json::Value> workspace_create_call(org, workspace, request_body)
### Parameters
**org** | **String** | | [required] |
**workspace** | **String** | | [required] |
**request_body** | [**std::collections::HashMap<String, serde_json::Value>**](SerdeJson__Value.md) | | [required] |
### Return type
[**std::collections::HashMap<String, serde_json::Value>**](serde_json::Value.md)
### Authorization
[bearerAuth](../README.md#bearerAuth)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## workspace_create_meeting_room
> std::collections::HashMap<String, serde_json::Value> workspace_create_meeting_room(org, workspace, request_body)
### Parameters
**org** | **String** | | [required] |
**workspace** | **String** | | [required] |
**request_body** | [**std::collections::HashMap<String, serde_json::Value>**](SerdeJson__Value.md) | | [required] |
### Return type
[**std::collections::HashMap<String, serde_json::Value>**](serde_json::Value.md)
### Authorization
[bearerAuth](../README.md#bearerAuth)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## workspace_delete_call_recording
> workspace_delete_call_recording(org, workspace, recording_id)
### Parameters
**org** | **String** | | [required] |
**workspace** | **String** | | [required] |
**recording_id** | **String** | | [required] |
### Return type
(empty response body)
### Authorization
[bearerAuth](../README.md#bearerAuth)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## workspace_end_call
> workspace_end_call(org, workspace, id)
### Parameters
**org** | **String** | | [required] |
**workspace** | **String** | | [required] |
**id** | **String** | | [required] |
### Return type
(empty response body)
### Authorization
[bearerAuth](../README.md#bearerAuth)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## workspace_get_bandwidth_history
> std::collections::HashMap<String, serde_json::Value> workspace_get_bandwidth_history(org, workspace)
### Parameters
**org** | **String** | | [required] |
**workspace** | **String** | | [required] |
### Return type
[**std::collections::HashMap<String, serde_json::Value>**](serde_json::Value.md)
### Authorization
[bearerAuth](../README.md#bearerAuth)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## workspace_get_bandwidth_summary
> std::collections::HashMap<String, serde_json::Value> workspace_get_bandwidth_summary(org, workspace)
### Parameters
**org** | **String** | | [required] |
**workspace** | **String** | | [required] |
### Return type
[**std::collections::HashMap<String, serde_json::Value>**](serde_json::Value.md)
### Authorization
[bearerAuth](../README.md#bearerAuth)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## workspace_get_call
> std::collections::HashMap<String, serde_json::Value> workspace_get_call(org, workspace, id)
### Parameters
**org** | **String** | | [required] |
**workspace** | **String** | | [required] |
**id** | **String** | | [required] |
### Return type
[**std::collections::HashMap<String, serde_json::Value>**](serde_json::Value.md)
### Authorization
[bearerAuth](../README.md#bearerAuth)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## workspace_get_meeting_room
> std::collections::HashMap<String, serde_json::Value> workspace_get_meeting_room(org, workspace, id)
### Parameters
**org** | **String** | | [required] |
**workspace** | **String** | | [required] |
**id** | **String** | | [required] |
### Return type
[**std::collections::HashMap<String, serde_json::Value>**](serde_json::Value.md)
### Authorization
[bearerAuth](../README.md#bearerAuth)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## workspace_join_call
> std::collections::HashMap<String, serde_json::Value> workspace_join_call(org, workspace, id)
### Parameters
**org** | **String** | | [required] |
**workspace** | **String** | | [required] |
**id** | **String** | | [required] |
### Return type
[**std::collections::HashMap<String, serde_json::Value>**](serde_json::Value.md)
### Authorization
[bearerAuth](../README.md#bearerAuth)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## workspace_leave_call
> workspace_leave_call(org, workspace, id)
### Parameters
**org** | **String** | | [required] |
**workspace** | **String** | | [required] |
**id** | **String** | | [required] |
### Return type
(empty response body)
### Authorization
[bearerAuth](../README.md#bearerAuth)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## workspace_list_active_calls
> std::collections::HashMap<String, serde_json::Value> workspace_list_active_calls(org, workspace)
### Parameters
**org** | **String** | | [required] |
**workspace** | **String** | | [required] |
### Return type
[**std::collections::HashMap<String, serde_json::Value>**](serde_json::Value.md)
### Authorization
[bearerAuth](../README.md#bearerAuth)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## workspace_list_call_recordings
> std::collections::HashMap<String, serde_json::Value> workspace_list_call_recordings(org, workspace, id)
### Parameters
**org** | **String** | | [required] |
**workspace** | **String** | | [required] |
**id** | **String** | | [required] |
### Return type
[**std::collections::HashMap<String, serde_json::Value>**](serde_json::Value.md)
### Authorization
[bearerAuth](../README.md#bearerAuth)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## workspace_start_call_recording
> std::collections::HashMap<String, serde_json::Value> workspace_start_call_recording(org, workspace, id)
### Parameters
**org** | **String** | | [required] |
**workspace** | **String** | | [required] |
**id** | **String** | | [required] |
### Return type
[**std::collections::HashMap<String, serde_json::Value>**](serde_json::Value.md)
### Authorization
[bearerAuth](../README.md#bearerAuth)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## workspace_stop_call_recording
> std::collections::HashMap<String, serde_json::Value> workspace_stop_call_recording(org, workspace, id, recording_id)
### Parameters
**org** | **String** | | [required] |
**workspace** | **String** | | [required] |
**id** | **String** | | [required] |
**recording_id** | **String** | | [required] |
### Return type
[**std::collections::HashMap<String, serde_json::Value>**](serde_json::Value.md)
### Authorization
[bearerAuth](../README.md#bearerAuth)
### HTTP request headers
- **Content-Type**: Not defined
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
## workspace_update_call_participant
> std::collections::HashMap<String, serde_json::Value> workspace_update_call_participant(org, workspace, id, request_body)
### Parameters
**org** | **String** | | [required] |
**workspace** | **String** | | [required] |
**id** | **String** | | [required] |
**request_body** | [**std::collections::HashMap<String, serde_json::Value>**](SerdeJson__Value.md) | | [required] |
### Return type
[**std::collections::HashMap<String, serde_json::Value>**](serde_json::Value.md)
### Authorization
[bearerAuth](../README.md#bearerAuth)
### HTTP request headers
- **Content-Type**: application/json
- **Accept**: application/json
[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)