List roles
curl --request GET \
--url https://api-prod.heliyos.ai/v1/auth/roles \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api-prod.heliyos.ai/v1/auth/roles', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api-prod.heliyos.ai/v1/auth/roles"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"meta": {
"message": "Roles fetched successfully"
},
"data": [
{
"id": "66a0f1e2d3c4b5a697880a01",
"name": "OWNER",
"createdAt": "2026-01-10T00:00:00.000Z",
"updatedAt": "2026-01-10T00:00:00.000Z"
},
{
"id": "66a0f1e2d3c4b5a697880a02",
"name": "ADMIN",
"createdAt": "2026-01-10T00:00:00.000Z",
"updatedAt": "2026-01-10T00:00:00.000Z"
},
{
"id": "66a0f1e2d3c4b5a697880a03",
"name": "MEMBER",
"createdAt": "2026-01-10T00:00:00.000Z",
"updatedAt": "2026-01-10T00:00:00.000Z"
}
]
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}Team
List roles
Returns the roles you can give people, with the ids that Invite a team member takes. Roles are the same for every workspace. Read the ids from this endpoint instead of hardcoding them.
GET
/
v1
/
auth
/
roles
List roles
curl --request GET \
--url https://api-prod.heliyos.ai/v1/auth/roles \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api-prod.heliyos.ai/v1/auth/roles', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api-prod.heliyos.ai/v1/auth/roles"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"meta": {
"message": "Roles fetched successfully"
},
"data": [
{
"id": "66a0f1e2d3c4b5a697880a01",
"name": "OWNER",
"createdAt": "2026-01-10T00:00:00.000Z",
"updatedAt": "2026-01-10T00:00:00.000Z"
},
{
"id": "66a0f1e2d3c4b5a697880a02",
"name": "ADMIN",
"createdAt": "2026-01-10T00:00:00.000Z",
"updatedAt": "2026-01-10T00:00:00.000Z"
},
{
"id": "66a0f1e2d3c4b5a697880a03",
"name": "MEMBER",
"createdAt": "2026-01-10T00:00:00.000Z",
"updatedAt": "2026-01-10T00:00:00.000Z"
}
]
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}In the Heliyos MCP server:
heliyos_team_members_change_role, heliyos_team_members_invite, heliyos_team_members_list, heliyos_team_members_remove.Authorizations
A workspace API key, sent as Authorization: Bearer heliyos_.... Create one in Heliyos under Settings → API keys. A key acts as a workspace admin in the one workspace it was created in.
Query Parameters
Narrows the list to the roles of one kind of workspace:
STANDARD:OWNER,ADMINandMEMBER.AGENCY:AGENCYonly.
Omit it for every role except Heliyos staff roles.
Available options:
AGENCY, STANDARD Was this page helpful?

