> ## Documentation Index
> Fetch the complete documentation index at: https://docs.drime.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Workspace Roles

> Get available workspace roles

## Overview

Returns a list of all available roles that can be assigned to workspace members.

## Response

<ResponseField name="pagination" type="object">
  Paginated list of roles

  <Expandable title="Pagination properties">
    <ResponseField name="data" type="array">
      Array of role objects
    </ResponseField>

    <ResponseField name="current_page" type="integer">
      Current page number
    </ResponseField>

    <ResponseField name="last_page" type="integer">
      Last page number
    </ResponseField>

    <ResponseField name="per_page" type="integer">
      Items per page
    </ResponseField>

    <ResponseField name="total" type="integer">
      Total number of roles
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="status" type="string">
  Request status (`success`)
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl https://app.drime.cloud/api/v1/workspace_roles \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://app.drime.cloud/api/v1/workspace_roles', {
    headers: {
      'Authorization': 'Bearer YOUR_ACCESS_TOKEN'
    }
  });

  const { pagination } = await response.json();
  const roles = pagination.data;
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://app.drime.cloud/api/v1/workspace_roles',
      headers={'Authorization': 'Bearer YOUR_ACCESS_TOKEN'}
  )

  roles = response.json()['pagination']['data']
  ```
</RequestExample>

<ResponseExample>
  ```json 200 - Success theme={null}
  {
    "pagination": {
      "data": [
        {
          "id": 1,
          "name": "Workspace Viewer",
          "description": "Can view files and folders",
          "type": "workspace"
        },
        {
          "id": 2,
          "name": "Workspace Editor",
          "description": "Can view, create, and edit files",
          "type": "workspace"
        },
        {
          "id": 3,
          "name": "Workspace Owner",
          "description": "Full access to workspace",
          "type": "workspace"
        }
      ],
      "current_page": 1,
      "last_page": 1,
      "per_page": 15,
      "total": 3
    },
    "status": "success"
  }
  ```
</ResponseExample>