---
title: "Get Custom Roles"
method: GET
path: "/v2/team/{team_id}/customroles"
tags: ["Roles"]
---

# Get Custom Roles

`GET /v2/team/{team_id}/customroles`

View the Custom Roles available in a Workspace.

## Path parameters

- `team_id` number, required

## Query parameters

- `include_members` boolean

## Response `200`

- object
  - `custom_roles` object[], required
    - `id` integer, required
    - `team_id` string, required
    - `name` string, required
    - `inherited_role` integer, required
    - `date_created` string, required
    - `members` integer[], required

---

[API](https://skmtc.net/clickup/apis/clickup-api-v2-reference.md) · [All operations](https://skmtc.net/clickup/apis/clickup-api-v2-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clickup/clickup-api-v2-reference/versions/72216f55b952/schema)