---
title: "List the roles of an organization. Only the organization owner, a delegated team member with the manageRoles, manageTeamMembers, manageAgencyClients or editBrand permission, or a collaborator with editBrand on any of the owner's brands may call this."
method: GET
path: "/v2/organizations/{organizationId}/roles"
tags: ["Organization Roles Api Service"]
---

# List the roles of an organization. Only the organization owner, a delegated team member with the manageRoles, manageTeamMembers, manageAgencyClients or editBrand permission, or a collaborator with editBrand on any of the owner's brands may call this.

`GET /v2/organizations/{organizationId}/roles`

## Request

- Base URL: `https://app.metricool.com/api`
- URL: `https://app.metricool.com/api/v2/organizations/{organizationId}/roles`
- Auth: none declared

## Path parameters

- `organizationId` integer, required

## Response `200`

Roles retrieved.

- JsonOkListResponseBrandRole
  - `metadata` object
  - `page` JsonPaging
    - `next` string
  - `data` BrandRole[]
    - `id` integer
    - `userId` integer, required
    - `name` string, required
    - `description` string
    - `color` string
    - `type` string
    - `assignable` boolean
    - `teamMemberOnly` boolean
    - `deletedDate` DateTimeInfo
      - `dateTime` string, required: Local Date-time represented with a certain timezone
      - `timezone` string: Timezone applied to the datetime
    - `deleted` boolean
    - `actions` BrandRoleActions, required
      - `viewAnalytics` boolean
      - `viewInbox` boolean
      - `viewPlanner` boolean
      - `viewAds` boolean
      - `viewSmartlinks` boolean
      - `fullAccessReports` boolean
      - `fullAccessInbox` boolean
      - `fullAccessPlanner` boolean
      - `fullAccessAds` boolean
      - `fullAccessSmartlinks` boolean
      - `fullAccessHashtagTracker` boolean
      - `editBrand` boolean
      - `schedulePosts` boolean
      - `publishPosts` boolean
      - `approvePosts` boolean
      - `viewCondensedAnalytics` boolean
      - `fullAccessDashboards` boolean
      - `viewDashboards` boolean
      - `editFlow` boolean
      - `viewFlow` boolean
      - `fullAccessStudio` boolean
    - `organizationActions` OrganizationRoleActionsDto, required: Organization-level permissions granted by a brand role, on top of the per-brand actions. Never null in a read response - a role that never had organization permissions set is reported with every field false.
      - `manageBrands` boolean: Whether the role can create and manage brands at the organization level.
      - `manageRoles` boolean: Whether the role can create and manage other brand roles at the organization level.
      - `manageTeamMembers` boolean: Whether the role can manage team members at the organization level.
      - `manageAgencyConfig` boolean: Whether the role can manage the agency configuration.
      - `manageAgencyClients` boolean: Whether the role can manage agency clients.
    - `assignedUsersCount` integer
    - `assignedEnabledCount` integer
    - `assignedDisabledCount` integer

## Other responses

- `400`: The organization owner's plan does not include shared profiles.
- `403`: Caller is not a regular-user session, the organization permissions feature is disabled for the organization's owner, the organization's owner's plan does not qualify for an organization, or the caller cannot read the roles of this organization.
- `404`: Organization not found, or its owner account could no longer be resolved.

---

[API](https://skmtc.dev/metricool/apis/metricool-api.md) · [All operations](https://skmtc.dev/metricool/apis/metricool-api/llms.txt) · [OpenAPI document](https://skmtc.dev/metricool/apis/metricool-api/revisions/aea9d9a8415a?raw)