Search Views

GET {{baseUrl}}/api/v2/views/search?query=<string>&access=<string>&active=<boolean>&group_id=<integer>&sort_by=<string>&sort_order=<string>&include=<string>

Pagination

  • Offset pagination only

See Using Offset Pagination.

Allowed For

  • Agents

Sideloads

The following sideloads are supported. For more information, see Side-loading.

NameWill sideload
app_installationThe app installation that requires each view, if present
permissionsThe permissions for each view

Request Params

KeyDatatypeRequiredDescription
querystring(Required) Query string used to find all views with matching title
accessstringFilter views by access. May be "personal", "shared", or "account"
activestringFilter by active views if true or inactive views if false
group_idstringFilter views by group
sort_bystringPossible values are "alphabetical", "created_at", "updated_at", and "position". If unspecified, the views are sorted by relevance
sort_orderstringOne of "asc" or "desc". Defaults to "asc" for alphabetical and position sort, "desc" for all others
includestringA sideload to include in the response. See Sideloads

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{&quot;count&quot;:2,&quot;next_page&quot;:null,&quot;previous_page&quot;:null,&quot;views&quot;:[{&quot;active&quot;:true,&quot;conditions&quot;:{},&quot;description&quot;:&quot;View for recent tickets&quot;,&quot;execution&quot;:{},&quot;id&quot;:25,&quot;position&quot;:3,&quot;restriction&quot;:{},&quot;title&quot;:&quot;Tickets updated less than 12 Hours&quot;},{&quot;active&quot;:false,&quot;conditions&quot;:{},&quot;description&quot;:&quot;View for tickets that are not assigned&quot;,&quot;execution&quot;:{},&quot;id&quot;:23,&quot;position&quot;:7,&quot;restriction&quot;:{},&quot;title&quot;:&quot;Unassigned tickets&quot;}]}