Admin Autocomplete Room Name for Private and Public Rooms

Prev Next
Get
/api/v1/rooms.autocomplete.adminRooms

List public and private rooms whose names match a given string, excluding DMs, and omnichannel rooms. This endpoint is valuable when performing search operations. Only workspace administrators can use it. Any one of the following permissions are required:

  • view-room-administration
  • can-audit
Header parameters
X-Auth-Token
stringRequired

The authToken of the authenticated user.

ExampleRScctEHSmLGZGywfIhWyRpyofhKOiMoUIpimhvheU3f
X-User-Id
stringRequired

The userId of the authenticated user.

ExamplerbAXPnMktTFbNpwtJ
Query parameters
selector
stringRequired

The term to be completed. It applies to room name and display name.

Example{"name":"ran"}
Responses
200

OK

Success
{
  "items": [
    {
      "_id": "664f0d815df46832f75b1877",
      "fname": "rangig",
      "name": "Ch9xkYwGHnsLe7CQR",
      "t": "c"
    },
    {
      "_id": "664f0d525df46832f75b1860",
      "fname": "rancher",
      "name": "rancher",
      "t": "p"
    },
    {
      "_id": "6630e94ad2226209149c67e2",
      "fname": "random",
      "name": "random",
      "t": "c"
    }
  ],
  "success": true
}
Expand All
object
items
Array of object
object
_id
string
fname
string
name
string
t
string
success
boolean
400

Bad Request

Selector Param Required
{
  "success": false,
  "error": "The 'selector' param is required"
}
object
success
boolean
error
string
401

Unauthorized

Authorization Error
{
  "status": "error",
  "message": "You must be logged in to do this."
}
object
status
string
message
string