Set a live event to ready

Sets a live event to ready. When a live event is in the ready state, users can start to enter the live event as participants and chat with the host. The host can stream their media but participants can’t watch or hear the host.

HTTP request

POST https://api-{application_id}.calls.sendbird.com/v1/live-events/{live_event_id}/ready

Response

If successful, this action returns a live event that has been set to ready in the response body.

Status: 200 OK

{
    "live_event": {
        "live_event_id": "60fce3f2-840a-49d2-99e9-4de7206010b5",
        "host_type": "single_host",
        "state": "ready",
        "created_at": 1657689627823,
        "set_ready_at": 1657689627867,
        "started_at": none,
        "ended_at": none,
        "is_host_streaming": false,
        "host": none,
        "created_by": "testuser-00be487",
        "set_ready_by": "testuser-00be487",
        "started_by": "",
        "ended_by": "",
        "duration": 0,
        "participant_count": 0,
        "peak_participant_count": 0,
        "cumulative_participant_count": 0,
        "user_ids_for_host": ["testuser-00be487"],
        "custom_items": {},
    }
}

List of response properties

Property name	Type	Description
live_event	nested object	The live event that has been set to ready.

On this page

HTTP request Response