---
title: "List security roles"
method: GET
path: "/security-roles"
tags: ["Security Roles"]
---

# List security roles

`GET /security-roles`

## Request

- Base URL: `https://www.ruddr.io/api/workspace`
- URL: `https://www.ruddr.io/api/workspace/security-roles`
- Auth: HTTP bearer

## Query parameters

- `startingAfter` string
- `endingBefore` string
- `limit` integer
- `modifiedAtAfter` union
  - string, date
  - string, date-time
- `modifiedAtOnAfter` union
  - string, date
  - string, date-time
- `modifiedAtBefore` union
  - string, date
  - string, date-time
- `modifiedAtOnBefore` union
  - string, date
  - string, date-time
- `name` string

## Response `200`

200

- object
  - `results` SecurityRole[]: The list of results for the current page.
    - `id` string: The unique identifier for the object.
    - `name` string: The name of the security role.
    - `description` string, nullable: A description of the security role. `null` when no description is set.
    - `isActive` boolean: Whether the security role is active.
    - `isDefault` boolean: Whether this is the default security role assigned to newly invited members.
    - `createdAt` string, date-time: The timestamp when the object was created.
    - `modifiedAt` string, date-time: The timestamp when the object was last modified.
  - `hasMore` boolean: Whether there are more results available after this page.

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/ruddr/apis/ruddr-api.md) · [All operations](https://skmtc.dev/ruddr/apis/ruddr-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ruddr/apis/ruddr-api/revisions/01c3f2a969ba?raw)