---
title: "GET /api/role/{workspace_id}/"
method: GET
path: "/api/role/{workspace_id}/"
tags: ["Role assignments"]
---

# GET /api/role/{workspace_id}/

`GET /api/role/{workspace_id}/`

You can list the role assignments within a workspace, optionally filtered downto a specific scope inside of that workspace. If the scope isn't specified,the workspace will be considered the scope.

## Path parameters

- `workspace_id` integer, required

## Query parameters

- `scope_id` integer
- `scope_type` string

## Response `200`

- OpenApiRoleAssignment[]
  - `id` integer, required
  - `role` string, required — The uid of the role assigned to the user or team in the given workspace.
  - `subject` OpenApiSubjectField, required
    - `id` integer, required
  - `subject_id` integer, required — The subject ID.
  - `scope_id` integer, required — The unique scope ID.
  - `subject_type` 'auth.User' | 'anonymous' | 'user_source.user' | 'core.Token' | 'baserow_enterprise.Team', required — * `auth.User` - auth.User * `anonymous` - anonymous * `user_source.user` - user_source.user * `core.Token` - core.Token * `baserow_enterprise.Team` - baserow_enterprise.Team
  - `scope_type` 'core' | 'application' | 'workspace' | 'workspace_invitation' | 'snapshot' | 'workspace_user' | 'integration' | 'user_source' | 'mcp_endpoint' | 'database' | 'database_table' | 'database_field' | 'database_view' | 'database_view_decoration' | 'database_view_sort' | 'database_view_group' | 'database_view_filter' | 'database_view_filter_group' | 'token' | 'builder' | 'builder_page' | 'builder_element' | 'builder_domain' | 'builder_data_source' | 'builder_workflow_action' | 'dashboard' | 'dashboard_data_source' | 'dashboard_widget' | 'automation' | 'automation_workflow' | 'automation_node' | 'team' | 'team_subject' | 'license', required — * `core` - core * `application` - application * `workspace` - workspace * `workspace_invitation` - workspace_invitation * `snapshot` - snapshot * `workspace_user` - workspace_user * `integration` - integration * `user_source` - user_source * `mcp_endpoint` - mcp_endpoint * `database` - database * `database_table` - database_table * `database_field` - database_field * `database_view` - database_view * `database_view_decoration` - database_view_decoration * `database_view_sort` - database_view_sort * `database_view_group` - database_view_group * `database_view_filter` - database_view_filter * `database_view_filter_group` - database_view_filter_group * `token` - token * `builder` - builder * `builder_page` - builder_page * `builder_element` - builder_element * `builder_domain` - builder_domain * `builder_data_source` - builder_data_source * `builder_workflow_action` - builder_workflow_action * `dashboard` - dashboard * `dashboard_data_source` - dashboard_data_source * `dashboard_widget` - dashboard_widget * `automation` - automation * `automation_workflow` - automation_workflow * `automation_node` - automation_node * `team` - team * `team_subject` - team_subject * `license` - license

## Other responses

- `400`
- `404`

---

[API](https://skmtc.net/baserow/apis/baserow-api-spec.md) · [All operations](https://skmtc.net/baserow/apis/baserow-api-spec/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/baserow/baserow-api-spec/versions/0c490e5b0c7f/schema)