---
title: "Update Group"
method: PUT
path: "/groups/{id}"
tags: ["Groups"]
---

# Update Group

`PUT /groups/{id}`

## Path parameters

- `id` string, id, required

## Request body

- object
  - `group` object
    - `name` string
    - `users` string[]

## Response `201`

The updated group

- Group
  - `id` string, required — A unique ID for the Group.
  - `company_id` string — A unique ID for the Company the Group belongs to
  - `name` string — The title of the Group
  - `users` User[] — A list of the group's users
    - `id` string, required
    - `company_id` string
    - `email_address` string
    - `status` 'active' | 'deleted' — Indicates the status of the Company.
    - `first_name` string
    - `last_name` string
    - `profile_image` ImageURI[] — A list of images for the different variants of the user profile image
      - `type` string, required
      - `uri` string, required
      - `url` string
    - `phone_number` string, nullable
    - `created_at` integer
    - `updated_at` integer
    - `user_url` string
  - `status` 'active' | 'deleted' — Indicates the status of the Group
  - `group_url` string — The link to the group in the web app
  - `created_at` integer — Timestamp when the Group was created on the server
  - `updated_at` integer — Timestamp when the Group was last updated

## Other responses

- `400` — Bad Request
- `404` — Not found
- `500` — Unexpected error

---

[API](https://skmtc.net/companycam/apis/core-api.md) · [All operations](https://skmtc.net/companycam/apis/core-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/companycam/core-api/versions/f2cd76b46603/schema)