# List roles

**GET /v1/security/roles**




## Servers
- http://localhost:9644: http://localhost:9644 ()



## Parameters


### Query parameters
- **filter** (string)
  Return only roles whose names match this substring
- **principal** (string)
  Return only roles which are assigned to this user
- **principal_type** (string)
  Applies to `principal` parameter. Ignored if `principal` is not set


## Responses
### 200
OK

#### Body: application/json (object)
- **roles** (array[object])



[Powered by Bump.sh](https://bump.sh)