Skip to API content
TalkLabs API Docs v3
Recipes
GET Chat

Get a room by custom ID

This will return all the settings for the room and the participant count but not the participant list.

GET /api/v3/{appid}/chat/roomsbycustomid/{customid}

This method requires authentication.

This will return all the settings for the room and the participant count but not the participant list.

Request

Parameters

Values in the path and query string.

appid path
string TalkLabs ID required

The TalkLabs application ID assigned to your account.

Example: your-app-id
customid path
string customer-defined required

A customer defined ID chosen by your application. TalkLabs stores it so you can retrieve the resource without keeping its TalkLabs ID.

Example: live-event-chat
Response

Status codes

Every JSON response uses the API result envelope.

200 OK ApiResult
400 Bad Request ApiResult
403 Forbidden ApiResult
404 Not Found ApiResult
500 Internal Server Error ApiResult
Example response · 200
{
  "message": "Success",
  "errors": {},
  "data": {
    "kind": "chat.room",
    "id": "5ec3c1945617e21bd8c5567b",
    "appid": "5ebbe03d5617e00de4b044c2",
    "ownerid": "userid_abe",
    "name": "New York City Chat (Post-Moderated)",
    "description": "Live from the top of the Empire State Building",
    "customtype": "",
    "customid": "new-york-city-club",
    "custompayload": "",
    "customtags": [],
    "customfield1": "",
    "customfield2": "",
    "enableactions": true,
    "enableenterandexit": true,
    "open": true,
    "inroom": 0,
    "added": "2020-05-19T11:23:00.3049587Z",
    "whenmodified": "2020-05-20T03:52:34.5114855Z",
    "moderation": "post",
    "maxreports": 0,
    "enableprofanityfilter": true,
    "delaymessageseconds": 0
  }
}
Search all 118 endpoints Try “join room”, “moderate”, or “POST”.
Request environment

Connect your application

These values fill request examples and the API console. They stay in this browser tab and are never sent to TalkLabs until you run a request.

Credentials are stored in sessionStorage, not in cookies or analytics.