# Get QueryAssist

## Request

```CURL
GET [[[<REST API URL>|Hub-Rest-Api-URL.html]]]/roles/queryAssist?query=string&amp;caret=int
```

|  Parameter  |  Description  |
| --- | --- |
|  `query`  |                            Optional. Lets you specify a search query to filter the returned results. See [Query Syntax](hub-api-query-syntax.html) for the definition of supported logical operations syntax. For the Roles, the following fields and tuples are supported:     has: permission — Default roles with some permissions      id: value — Service default role with the given ID      key: value — Default roles with the given key      name: value — Default roles with the given name      permission: permission — Default roles that include the given permission      has: permission — Roles with some permissions      id: value — Role with the given ID      key: roleKey — Role with the given key      name: roleName — Role with the given name      permission: permission — Roles that includes the given permission      permission(key: permissionKey, service: service) — Roles that includes the given permission      permission(service: service) — Roles that have at least one permission from service     |
|  `caret`  |                              Query parameter of type int.  |

## Response

|  Response Code  |  Meaning  |
| --- | --- |
|  200 OK  |  Successful request.  |
|  400 Bad Request  |  At least one of the request parameters is invalid. For example, a required field in the passed JSON object is missing. For details, check the error message in the response.  |
|  403 Forbidden  |  The requester has no access to the requested resource.  |
|  404 Not Found  |  The requested resource was not found.  |
|  500 Internal Server Error  |  Failed to process request because of the server error. For details, check the error message in the response.  |

### Response body

```JSON
{
  "query": string, 
  "caret": int, 
  "styleRanges": [[[[queryStyleRange|HUB-REST-API_JSON-Scheme.html#queryStyleRange]]], ...], 
  "suggestions": [[[[querySuggestItem|HUB-REST-API_JSON-Scheme.html#querySuggestItem]]], ...]
}
```