v2

OpenAPI 3.0.12026-08-0174115357.9 KB
Servicedesk

Get request types

This method returns all customer request types from a service desk. There are two parameters for filtering the returned list:

  • groupId which filters the results to items in the customer request type group.
  • searchQuery which is matched against request types' name or description. For example, the strings "Install", "Inst", "Equi", or "Equipment" will match a request type with the name "Equipment Installation Request".

Note: This API by default will filter out request types hidden in the portal (i.e. request types without groups and request types where a user doesn't have permission) when searchQuery is provided, unless includeHiddenRequestTypesInSearch is set to true. Restricted request types will not be returned for those who aren't admins.

Permissions required: Permission to access the service desk.

get/rest/servicedeskapi/servicedesk/{serviceDeskId}/requesttype

Path parameters

serviceDeskIdstring required

The ID of the service desk whose customer request types are to be returned. This can alternatively be a project identifier.

Query parameters

groupIdinteger

Filters results to those in a customer request type group.

expandstring[]
searchQuerystring

The string to be used to filter the results.

startinteger

The starting index of the returned objects. Base index: 0. See the Pagination section for more details.

limitinteger

The maximum number of items to return per page. Default: 50. See the Pagination section for more details.

includeHiddenRequestTypesInSearchboolean

Whether to include hidden request types when searching with searchQuery.

restrictionStatusstring

Request type restriction status (open or restricted) used to filter the results.

Response

Returns the requested customer request types, on the specified page of the results.

_expandsstring[]
isLastPageboolean

Indicates if this is the last page of records (true) or not (false).

limitinteger

Number of items to be returned per page, up to the maximum set for these objects in the current implementation.

sizeinteger

Number of items returned in the page.

startinteger

Index of the first item returned in the page.