---
title: "Update SCIM group"
method: PUT
path: "/v1/provisioning/scim/Groups/{groupId}"
tags: ["Accounts and users"]
---

# Update SCIM group

`PUT /v1/provisioning/scim/Groups/{groupId}`

## Request

- Base URL: `https://yourbaseurl.talon.one`
- URL: `https://yourbaseurl.talon.one/v1/provisioning/scim/Groups/{groupId}`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `Authorization`
- TypeScript: <https://skmtc.dev/talon/apis/management-api/docs/v1/provisioning/scim/Groups/:groupId/put.ts> (a function with typed inputs; its response is checked against the schema)

> [!note] Management API endpoints are **not** meant to be used in real-time integrations that directly serve your end users. Rate limit: 3 requests per second.

Update the details of a specific group created using the SCIM provisioning protocol with an identity provider, for example, Microsoft Entra ID. This endpoint replaces all attributes of the given group with the attributes provided in the request payload.
In Talon.One, a `Group` corresponds to a [role](https://docs.talon.one/docs/product/account/account-settings/managing-roles), and `members` are the [users](https://docs.talon.one/docs/product/account/account-settings/managing-users) assigned to that role.

## Path parameters

- `groupId` integer, required

## Request body

- ScimBaseGroup: Define the schema for base fields in a group using the SCIM provisioning protocol. Talon.One uses this schema to create roles.
  - `displayName` string: Display name of the group (Talon.One role).
  - `members` ScimGroupMember[]: List of members to assign to the new Talon.One role.
    - `value` string: Unique identifier of the member.
    - `display` string: Identifier of the user. This is usually an email address.

## Response `200`

Group details

- ScimGroup: Define the schema for base fields in a group using the SCIM provisioning protocol. Talon.One uses this schema to create roles.
  - `displayName` string: Display name of the group (Talon.One role).
  - `members` ScimGroupMember[]: List of members to assign to the new Talon.One role.
    - `value` string: Unique identifier of the member.
    - `display` string: Identifier of the user. This is usually an email address.
  - `id` string, required: ID of the group.

---

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