---
title: "Update group"
method: PUT
path: "/api/v1/organizations/{organizationID}/groups/{groupid}"
tags: ["Groups"]
---

# Update group

`PUT /api/v1/organizations/{organizationID}/groups/{groupid}`

Allows a group to be updated.

## Request body

- GroupWrite — A group when created or updated.
  - `metadata` ResourceMetadata, required — Metadata required for all API resource reads and writes.
    - `name` string, required — A valid Kubernetes label value, typically used for resource names that can be indexed in the database.
    - `description` string — The resource description, this optionally augments the name with more context.
    - `tags` Tag[] — A list of tags.
      - `name` string, required — A unique tag name.
      - `value` string, required — The value of the tag.
  - `spec` GroupSpec, required — A group.
    - `subjects` Subject[] — list of subjects that are assigned to this group
      - `id` string, required — The identitifier for this subject, given by the issuer.
      - `email` string — An email for the user, if supplied by the issuer.
      - `issuer` string, required — The issuer URL.
    - `userIDs` string[] — A list of strings.
    - `serviceAccountIDs` string[], required — A list of strings.
    - `roleIDs` string[], required — A list of strings.

## Response `200`

Group successfully updated and returned.

## Other responses

- `401` — Authentication failed or the access token has expired.
- `403` — Request was denied by authorization, this may be caused by the authorization token not having the required scope for an API, or the user doesn't have the necessary privileges on the provider platform.
- `404` — Unable to find a resource.
- `500` — An unexpected or unhandled error occurred. This may be a transient error and may succeed on a retry. If this isn't the case, please report it as an issue.

---

[API](https://skmtc.dev/nscale/apis/region-service-api.md) · [All operations](https://skmtc.dev/nscale/apis/region-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nscale/region-service-api/revisions/c2991b23da6e/schema)