---
title: "POST /api/v1/groups/{groupId}/roles"
method: POST
path: "/api/v1/groups/{groupId}/roles"
tags: ["Group"]
---

# POST /api/v1/groups/{groupId}/roles

`POST /api/v1/groups/{groupId}/roles`

## Request

- Base URL: `https://your-subdomain.okta.com`
- URL: `https://your-subdomain.okta.com/api/v1/groups/{groupId}/roles`
- Auth: API key in header `Authorization`

Assigns a Role to a Group

## Path parameters

- `groupId` string, required

## Query parameters

- `disableNotifications` boolean

## Request body

- AssignRoleRequest
  - `type` 'SUPER_ADMIN' | 'ORG_ADMIN' | 'APP_ADMIN' | 'USER_ADMIN' | 'HELP_DESK_ADMIN' | 'READ_ONLY_ADMIN' | 'MOBILE_ADMIN' | 'API_ACCESS_MANAGEMENT_ADMIN' | 'REPORT_ADMIN' | 'GROUP_MEMBERSHIP_ADMIN' | 'CUSTOM'

## Response `200`

Success

- Role
  - `_embedded` object
  - `_links` object
  - `assignmentType` 'GROUP' | 'USER'
  - `created` string, date-time
  - `description` string
  - `id` string
  - `label` string
  - `lastUpdated` string, date-time
  - `status` 'ACTIVE' | 'INACTIVE'
  - `type` 'SUPER_ADMIN' | 'ORG_ADMIN' | 'APP_ADMIN' | 'USER_ADMIN' | 'HELP_DESK_ADMIN' | 'READ_ONLY_ADMIN' | 'MOBILE_ADMIN' | 'API_ACCESS_MANAGEMENT_ADMIN' | 'REPORT_ADMIN' | 'GROUP_MEMBERSHIP_ADMIN' | 'CUSTOM'

## Other responses

- `201`: Success

---

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