Retrieve a conference
GET/conferences/:id
Retrieve an existing conference
Request
Path Parameters
Uniquely identifies the conference by id
Responses
200: Successful response with details about a conference.
- application/json
- Schema
- Example (from schema)
Schema
data
object
Possible values: [conference
]
Uniquely identifies the conference
Name of the conference
ISO 8601 formatted date of when the conference was created
ISO 8601 formatted date of when the conference will expire
ISO 8601 formatted date of when the conference was last updated
Region where the conference is hosted
Possible values: [init
, in_progress
, completed
]
Status of the conference
Possible values: [all_left
, ended_via_api
, host_left
, time_exceeded
]
Reason why the conference ended
ended_by
object
IDs related to who ended the conference. It is expected for them to all be there or all be null
Call Control ID which ended the conference
Call Session ID which ended the conference
IDs related to who ended the conference. It is expected for them to all be there or all be null
Identifies the connection associated with the conference
{
"data": {
"record_type": "conference",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "All hands meeting",
"created_at": "2019-01-23T18:10:02.574Z",
"expires_at": "2019-01-23T18:10:02.574Z",
"updated_at": "2019-01-23T18:10:02.574Z",
"region": "sv1",
"status": "completed",
"end_reason": "all_left",
"ended_by": {
"call_control_id": "v2:T02llQxIyaRkhfRKxgAP8nY511EhFLizdvdUKJiSw8d6A9BborherQczRrZvZakpWxBlpw48KyZQ==",
"call_session_id": "428c31b6-abf3-3bc1-b7f4-5013ef9657c1"
},
"connection_id": "3fa85f64-9191-4567-b3fc-2c963f66afa6"
}
}
404: Conference does not exist