Clickup Roles API
The Roles API from Clickup — 1 operation(s) for roles.
Operations 1
Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/clickup-roles-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: ClickUp API v2 Reference Roles API
description: The ClickUp API enables you to programmatically access and manage your ClickUp resources.
contact: {}
version: '2.0'
servers:
- url: https://api.clickup.com/api
description: ClickUp
variables: {}
security:
- Authorization_Token: []
tags:
- name: Roles
paths:
/v2/team/{team_id}/customroles:
parameters: []
get:
summary: Get Custom Roles
tags:
- Roles
description: View the Custom Roles available in a Workspace.
operationId: GetCustomRoles
parameters:
- name: team_id
in: path
description: Workspace ID
required: true
style: simple
schema:
type: number
contentEncoding: double
examples:
- 123
- name: include_members
in: query
description: ''
style: form
explode: true
schema:
type: boolean
examples:
- true
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
title: GetCustomRolesresponse
required:
- custom_roles
type: object
properties:
custom_roles:
type: array
items:
title: CustomRole2
required:
- id
- team_id
- name
- inherited_role
- date_created
- members
type: object
properties:
id:
type: integer
contentEncoding: int32
team_id:
type: string
name:
type: string
inherited_role:
type: integer
contentEncoding: int32
date_created:
type: string
members:
type: array
items:
type: integer
contentEncoding: int32
description: ''
examples:
- id: 4547089
team_id: '301539'
name: guest custom
inherited_role: 4
date_created: '1651189835671'
members:
- 12345
- 67899
description: ''
examples:
- custom_roles:
- id: 4547089
team_id: '301539'
name: guest custom
inherited_role: 4
date_created: '1651189835671'
members:
- 12345
- 67899
- id: 6715664
team_id: '301539'
name: member custom
inherited_role: 3
date_created: '1651189901020'
members:
- 5553
- 98989
- id: 2957195
team_id: '301539'
name: admin custom
inherited_role: 2
date_created: '1651189904868'
members:
- 47474
- 818181
example:
custom_roles:
- id: 4547089
team_id: '301539'
name: guest custom
inherited_role: 4
date_created: '1651189835671'
members:
- 12345
- 67899
- id: 6715664
team_id: '301539'
name: member custom
inherited_role: 3
date_created: '1651189901020'
members:
- 5553
- 98989
- id: 2957195
team_id: '301539'
name: admin custom
inherited_role: 2
date_created: '1651189904868'
members:
- 47474
- 818181
deprecated: false
components:
securitySchemes:
Authorization_Token:
name: Authorization
type: apiKey
in: header
description: 'API token required for authentication. Two types of tokens are supported:
**Personal API Key** Obtain from ClickUp''s settings page under ''Apps'' and add it to the header as `Authorization: pk_...`
**OAuth2 Access Token** Generated through the OAuth2 flow and add it to the header as `Authorization: Bearer {access_token}`'