---
title: "Changes to List Roles"
method: GET
path: "/api/v2/roles"
---

# Changes to List Roles

`GET /api/v2/roles`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 4 of 66 revisions.

- **2026-04-01** `40bf219eced6` — 5 breaking, 4 info
- **2026-04-01** `6aaeba6ecdc5` — 4 breaking, 5 info
- **2026-04-01** `674e0a229e8a` — 5 breaking, 4 info
- **2026-01-12** `a426ff0abf8f` — 4 breaking, 5 info

## Changes

- **2026-04-01** `40bf219eced6` — 5 breaking, 4 info
  - added the pattern `^((eq|neq|gt|gte|lt|lte):)?-?[0-9]+$` to the `query` request parameter `id`
  - added the pattern `^((eq|neq|gt|gte|lt|lte):)?[0-9]{4}-[0-9]{2}-[0-9]{2}[Tt][0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]{1,9})?([Zz]|-[0-9]{2}:[0-9]{2})$` to the `query` request parameter `created_at`
  - added the pattern `^((eq|neq|gt|gte|lt|lte):)?[0-9]{4}-[0-9]{2}-[0-9]{2}[Tt][0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]{1,9})?([Zz]|-[0-9]{2}:[0-9]{2})$` to the `query` request parameter `deleted_at`
  - added the pattern `^((eq|neq|gt|gte|lt|lte):)?[0-9]{4}-[0-9]{2}-[0-9]{2}[Tt][0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]{1,9})?([Zz]|-[0-9]{2}:[0-9]{2})$` to the `query` request parameter `updated_at`
  - added the pattern `^((eq|~eq|neq):)?[^:]+$` to the `query` request parameter `name`
  - for the `query` request parameter `created_at`, the type/format was generalized from `string`/`date-time` to `string`/``
  - for the `query` request parameter `deleted_at`, the type/format was generalized from `string`/`date-time` to `string`/``
  - for the `query` request parameter `id`, the type/format was generalized from `integer`/`` to `string`/``
  - for the `query` request parameter `updated_at`, the type/format was generalized from `string`/`date-time` to `string`/``
- **2026-04-01** `6aaeba6ecdc5` — 4 breaking, 5 info
  - for the `query` request parameter `created_at`, the type/format was changed from `string`/`` to `string`/`date-time`
  - for the `query` request parameter `deleted_at`, the type/format was changed from `string`/`` to `string`/`date-time`
  - for the `query` request parameter `id`, the type/format was changed from `string`/`` to `integer`/``
  - for the `query` request parameter `updated_at`, the type/format was changed from `string`/`` to `string`/`date-time`
  - removed the pattern `^((eq|neq|gt|gte|lt|lte):)?-?[0-9]+$` from the `query` request parameter `id`
  - removed the pattern `^((eq|neq|gt|gte|lt|lte):)?[0-9]{4}-[0-9]{2}-[0-9]{2}[Tt][0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]{1,9})?([Zz]|-[0-9]{2}:[0-9]{2})$` from the `query` request parameter `created_at`
  - removed the pattern `^((eq|neq|gt|gte|lt|lte):)?[0-9]{4}-[0-9]{2}-[0-9]{2}[Tt][0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]{1,9})?([Zz]|-[0-9]{2}:[0-9]{2})$` from the `query` request parameter `deleted_at`
  - removed the pattern `^((eq|neq|gt|gte|lt|lte):)?[0-9]{4}-[0-9]{2}-[0-9]{2}[Tt][0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]{1,9})?([Zz]|-[0-9]{2}:[0-9]{2})$` from the `query` request parameter `updated_at`
  - removed the pattern `^((eq|~eq|neq):)?[^:]+$` from the `query` request parameter `name`
- **2026-04-01** `674e0a229e8a` — 5 breaking, 4 info
  - added the pattern `^((eq|neq|gt|gte|lt|lte):)?-?[0-9]+$` to the `query` request parameter `id`
  - added the pattern `^((eq|neq|gt|gte|lt|lte):)?[0-9]{4}-[0-9]{2}-[0-9]{2}[Tt][0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]{1,9})?([Zz]|-[0-9]{2}:[0-9]{2})$` to the `query` request parameter `created_at`
  - added the pattern `^((eq|neq|gt|gte|lt|lte):)?[0-9]{4}-[0-9]{2}-[0-9]{2}[Tt][0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]{1,9})?([Zz]|-[0-9]{2}:[0-9]{2})$` to the `query` request parameter `deleted_at`
  - added the pattern `^((eq|neq|gt|gte|lt|lte):)?[0-9]{4}-[0-9]{2}-[0-9]{2}[Tt][0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]{1,9})?([Zz]|-[0-9]{2}:[0-9]{2})$` to the `query` request parameter `updated_at`
  - added the pattern `^((eq|~eq|neq):)?[^:]+$` to the `query` request parameter `name`
  - for the `query` request parameter `created_at`, the type/format was generalized from `string`/`date-time` to `string`/``
  - for the `query` request parameter `deleted_at`, the type/format was generalized from `string`/`date-time` to `string`/``
  - for the `query` request parameter `id`, the type/format was generalized from `integer`/`` to `string`/``
  - for the `query` request parameter `updated_at`, the type/format was generalized from `string`/`date-time` to `string`/``
- **2026-01-12** `a426ff0abf8f` — 4 breaking, 5 info
  - for the `query` request parameter `created_at`, the type/format was changed from `string`/`` to `string`/`date-time`
  - for the `query` request parameter `deleted_at`, the type/format was changed from `string`/`` to `string`/`date-time`
  - for the `query` request parameter `id`, the type/format was changed from `string`/`` to `integer`/``
  - for the `query` request parameter `updated_at`, the type/format was changed from `string`/`` to `string`/`date-time`
  - removed the pattern `^((eq|neq|gt|gte|lt|lte):)?-?[0-9]+$` from the `query` request parameter `id`
  - removed the pattern `^((eq|neq|gt|gte|lt|lte):)?[0-9]{4}-[0-9]{2}-[0-9]{2}[Tt][0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]{1,9})?([Zz]|-[0-9]{2}:[0-9]{2})$` from the `query` request parameter `created_at`
  - removed the pattern `^((eq|neq|gt|gte|lt|lte):)?[0-9]{4}-[0-9]{2}-[0-9]{2}[Tt][0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]{1,9})?([Zz]|-[0-9]{2}:[0-9]{2})$` from the `query` request parameter `deleted_at`
  - removed the pattern `^((eq|neq|gt|gte|lt|lte):)?[0-9]{4}-[0-9]{2}-[0-9]{2}[Tt][0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]{1,9})?([Zz]|-[0-9]{2}:[0-9]{2})$` from the `query` request parameter `updated_at`
  - removed the pattern `^((eq|~eq|neq):)?[^:]+$` from the `query` request parameter `name`

---

[Operation](https://skmtc.dev/specterops/apis/bloodhound-api/docs/api/v2/roles/get.md) · [API](https://skmtc.dev/specterops/apis/bloodhound-api.md) · [Page](https://skmtc.dev/specterops/apis/bloodhound-api/changes/api/v2/roles/get)