跳到主要内容

searchRooms

FolderContentWrapper searchRooms(RoomsMetadataSearchRequestDto)

POST /api/2.0/files/rooms/search

Search the rooms by metadata

Searches the rooms by metadata. The same filter the rooms listing takes in the metadataTemplateId and metadataFilters query parameters, here as a typed request body for the clients that build the conditions as objects rather than as a JSON string.

Parameters​

NameInTypeDescriptionNotes
RoomsMetadataSearchRequestDtobodyRoomsMetadataSearchRequestDto[optional]

Responses​

Status codeDescriptionTypeResponse headers
200Returns the matching rooms of the sectionFolderContentWrapperX-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset
400Invalid metadata filter--
403You don't have enough permission to view the room content--
401UnauthorizedErrorApiResponse-
429Too Many Requests.ErrorApiResponseRetry-After
500Internal Server Error.ErrorApiResponse-
502Bad Gateway. Returned by the reverse proxy, response body may be HTML and not JSON.--
503Service Unavailable. Returned by the reverse proxy, response body may be HTML and not JSON.--

Return type​

FolderContentWrapper

Authorization​

Basic, OAuth2 (scopes: read, write), ApiKeyBearer, asc_auth_key, Bearer, OpenId

HTTP request headers​

  • Content-Type: application/json
  • Accept: application/json