---
title: "GET /v2/authorization/{userId}/roles"
method: GET
path: "/v2/authorization/{userId}/roles"
tags: ["Brand Roles Api Service"]
---

# GET /v2/authorization/{userId}/roles

`GET /v2/authorization/{userId}/roles`

## Request

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

## Path parameters

- `userId` integer, required

## Response `200`

OK

- 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

---

[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/cd0ca612fa01?raw)