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

# Update SCIM group attributes

`PATCH /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/patch.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 certain attributes of a group created using the SCIM provisioning protocol with an identity provider, for example, Microsoft Entra ID. This endpoint allows for selective adding, removing, or replacing of specific group attributes while other attributes remain unchanged.
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

- ScimPatchRequest: SCIM Patch request
  - `schemas` string[]: SCIM schema for the given resource.
  - `Operations` ScimPatchOperation[], required
    - `op` 'add' | 'remove' | 'replace', required: The method that should be used in the operation.
    - `path` string: The path specifying the attribute that should be updated.
    - `value` string: The value that should be updated. Required if `op` is `add` or `replace`.

## 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)