---
title: "User role definitions"
method: GET
path: "/users/roles"
tags: ["Users / Roles"]
---

# User role definitions

`GET /users/roles`

Gets list of all existing user role names and IDs. Optionally filter by `category`, a specific `roleId`, or pass `organizationId`/`teamId` to include custom roles for that organization. Set the user roles in an organization with the `POST /users/{userId}/user-organization-roles/{organizationId}` API call. Use the `POST /users/{userId}/user-team-roles/{teamId}` API call to set user roles in a team.

## Query parameters

- `cols[]` string[]
- `category` 'organization' | 'team'
- `organizationId` integer
- `teamId` integer
- `roleId` integer
- `excludeRole[]` integer[]

## Response `200`

Successful response

- object
  - `usersRoles` object[]
    - `id` integer
    - `name` string
    - `identifier` string
    - `subsidiary` boolean
    - `category` string
    - `permissions` string[]
    - `managementType` 'system_locked' | 'admin_managed' | 'custom_managed' — Indicates how the role is managed.
    - `description` string, nullable

## Other responses

- `400` — Bad request. Returned when `organizationId` and `teamId` are both provided and the team does not belong to the specified organization.

---

[API](https://skmtc.dev/make/apis/web-api-v2-public.md) · [All operations](https://skmtc.dev/make/apis/web-api-v2-public/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/make/web-api-v2-public/revisions/531769e6f813/schema)