Skip to main content

RoomsMetadataSearchRequestDto

The typed form of the metadata search of the rooms: the same filter the rooms listing takes in the metadataTemplateId and metadataFilters query parameters, with the conditions as objects instead of a JSON string.

NameTypeDescriptionNotes
metadataTemplateIdInteger (int32)The ID of the metadata template the rooms must be assigned to. On its own it narrows the listing to the rooms carrying the template; together with the conditions it also pins the template the filtered fields belong to.[optional] [example: 1] [nullable]
metadataFiltersListThe metadata filter conditions, combined with AND. A custom field is addressed by its name instead of the field ID.[optional] [example: [{fieldId=1, op=eq, value=ACME}, {name=Client, op=eq, value=ACME}]] [nullable]
includeHiddenMetadataBooleanWhether the text search, and the metadataMatches it reports, also look at the values of the hidden metadata templates (created with visible false for the metadata a service keeps for itself, which the web client never shows). False, the default, leaves them out, so an entry is not found by such a value; true takes them in. metadataTemplateId and metadataFilters are not concerned: a hidden template or field named there is searched either way.[optional] [example: false] [nullable]
filterValueStringThe text to search for in the room titles and in the string metadata values of the rooms, the custom fields and the template fields alike; a room found by its metadata says where in metadataMatches.[optional] [example: ACME] [nullable]
searchAreaSearchAreaThe section to search in: the active rooms (the default), the archive or the templates.[optional] [enum: Active, Archive, Any, RecentByLinks, Templates, Knowledge, ResultStorage, AiAgents, Forms, FormTemplates]
typeListThe room types to search among.[optional] [example: [5]] [nullable]
countInteger (int32)The number of rooms to return, from 1 to 100.[optional] [example: 25] [min: 1] [max: 100]
startIndexInteger (int32)The zero-based index of the first room to return.[optional] [example: 0] [min: 0] [max: 2147483647]
sortByStringThe field to sort by, a name of the SortedByType values.[optional] [example: DateAndTime] [nullable]
sortOrderSortOrderThe sort order.[optional] [enum: 0, 1]