---
title: "Replaces group roles for an app"
method: PUT
path: "/apps/{app-slug}/roles/{role-name}"
tags: ["application"]
---

# Replaces group roles for an app

`PUT /apps/{app-slug}/roles/{role-name}`

Replaces the groups for a given role on an app. Only the given groups will be present for a role on the app after this call.

## Path parameters

- `app-slug` string, required
- `role-name` 'admin' | 'manager' | 'member' | 'platform_engineer', required

## Request body

- object
  - `groups` string[]

## Response `200`

List of group slugs

- object
  - `groups` string[]

## Other responses

- `422` — Unprocessable Entity

---

[API](https://skmtc.net/bitrise/apis/bitrise-api.md) · [All operations](https://skmtc.net/bitrise/apis/bitrise-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bitrise/bitrise-api/revisions/89468e4a014b/schema)