Skip to content

Interface: RoomsApi ​

The methods of Talkline.rooms.

Methods ​

create() ​

ts
create(body?): Promise<Room>;

POST /v1/rooms.

Parameters ​

ParameterType
body?CreateRoomRequest

Returns ​

Promise<Room>


end() ​

ts
end(sid): Promise<void>;

DELETE /v1/rooms/{sid}: everyone in it leaves as evicted; ending an ended room is not an error.

Parameters ​

ParameterType
sidstring

Returns ​

Promise<void>


evict() ​

ts
evict(sid, identity): Promise<void>;

DELETE /v1/rooms/{sid}/participants/{identity}.

Parameters ​

ParameterType
sidstring
identitystring

Returns ​

Promise<void>


get() ​

ts
get(sid): Promise<RoomDetail>;

GET /v1/rooms/{sid}: with the participants in it now and their live tracks.

Parameters ​

ParameterType
sidstring

Returns ​

Promise<RoomDetail>


iterate() ​

ts
iterate(query?): AsyncIterable<Room>;

GET /v1/rooms, every page in turn.

Parameters ​

ParameterType
query?Pageless<ListRoomsQuery>

Returns ​

AsyncIterable<Room>


iterateParticipants() ​

ts
iterateParticipants(sid, query?): AsyncIterable<Participant>;

GET /v1/rooms/{sid}/participants, every page in turn.

Parameters ​

ParameterType
sidstring
query?Pageless<ListParticipantsQuery>

Returns ​

AsyncIterable<Participant>


list() ​

ts
list(query?): Promise<Page<Room>>;

GET /v1/rooms, one page.

Parameters ​

ParameterType
query?ListRoomsQuery

Returns ​

Promise<Page<Room>>


listParticipants() ​

ts
listParticipants(sid, query?): Promise<Page<Participant>>;

GET /v1/rooms/{sid}/participants, one page.

Parameters ​

ParameterType
sidstring
query?ListParticipantsQuery

Returns ​

Promise<Page<Participant>>


sendData() ​

ts
sendData(sid, message): Promise<SendDataResult>;

POST /v1/rooms/{sid}/data.

Parameters ​

ParameterType
sidstring
messageSendDataRequest

Returns ​

Promise<SendDataResult>


updateParticipant() ​

ts
updateParticipant(
   sid, 
   identity, 
   body
): Promise<Participant>;

PATCH /v1/rooms/{sid}/participants/{identity}.

Parameters ​

ParameterType
sidstring
identitystring
bodyUpdateParticipantRequest

Returns ​

Promise<Participant>

Talkline documentation