---
title: "Modify Group or Team"
method: PUT
path: "/Groups/{id}"
tags: ["Groups"]
---

# Modify Group or Team

`PUT /Groups/{id}`

## Request

- Base URL: `https://users.lucid.app/scim/v2`
- URL: `https://users.lucid.app/scim/v2/Groups/{id}`
- Auth: HTTP bearer

Modify an existing org group or team.

## Parameters

- `#/paths/~1Groups~1{id}/get/parameters/0` (unresolved $ref)
- `#/paths/~1Groups/get/parameters/3` (unresolved $ref)
- `#/paths/~1Groups/get/parameters/4` (unresolved $ref)

## Request body

- CreateOrUpdateGroup
  - `schemas` string[]: URIs identifying the SCIM schemas that describe this resource's attributes.
  - `displayName` string: The name of the org group or team.
  - `members` Member[]
    - `value` string, required: The ID of the member. For org groups, this can be a user ID (e.g. "lucid-1234") or a subgroup ID (e.g. "lucid-group-5678"). For teams, only user IDs are supported.
    - `$ref` string: The URI of the member. Points to /Users/{id} for user members, or for org groups, /Groups/{id} for subgroup members.
    - `display` string: The display name of the member (the user's name, or for org group subgroups, the subgroup's name).

## Response `200`

OK. Returns the modified group or team.

- Group
  - `id` string: Will be in the form "lucid-group-1234" with 1234 being the ID of the Lucid org group or team.
  - `schemas` string[]: URIs identifying the SCIM schemas that describe this resource's attributes.
  - `displayName` string: The name of the org group or team.
  - `members` Member[]: The users (and, for org groups, subgroups) that are members of this org group or team.
    - `value` string, required: The ID of the member. For org groups, this can be a user ID (e.g. "lucid-1234") or a subgroup ID (e.g. "lucid-group-5678"). For teams, only user IDs are supported.
    - `$ref` string: The URI of the member. Points to /Users/{id} for user members, or for org groups, /Groups/{id} for subgroup members.
    - `display` string: The display name of the member (the user's name, or for org group subgroups, the subgroup's name).
  - `meta` object

## Other responses

- `401`: Unauthorized. Occurs if the bearer token is invalid.
- `404`: Not Found. Occurs if the group was not found.
- `409`: Conflict. Occurs if the group name already exists on the account. Org group and team namespaces are distinct, though the latter includes archived teams.
- `429` (unresolved $ref)

---

[API](https://skmtc.dev/lucid/apis/lucid-scim-api.md) - [All operations](https://skmtc.dev/lucid/apis/lucid-scim-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lucid/apis/lucid-scim-api/revisions/840cb3f88aa6?raw)