When a user joins a monday.com account, they are assigned a role that specifies their permissions and what actions they can perform. All accounts have admin, member, viewer, and guest roles by default; some monday.com plans also allow you to create custom roles.

Queries

Get account roles

• Required scope:account:read
• Returns an object containing metadata about all user roles in an account (both default and custom)
• Can only be queried directly at the root; can't be nested within another query

query {
  account_roles {
    id
    name
    roleType
  }
}

import { ApiClient } from "@mondaydotcomorg/api";
const mondayApiClient = new ApiClient({ token: myToken });

const query = `query { account_roles { id name roleType } }`;
const response = await mondayApiClient.request(query);

Fields