---
title: "Create or update a group"
method: PUT
path: "/api/groups/{id}"
tags: ["group-resource"]
---

# Create or update a group

`PUT /api/groups/{id}`

## Path parameters

- `id` string, required

## Request body

- UpsertGroupRequest
  - `contactInformation` object — Group's contact information
  - `defaultAccess` object — a default Map<TargetType, Set<Access> to share permissions, allowed target types: WORKFLOW_DEF, AGENT, TASK_DEF, WORKFLOW_SCHEDULE
  - `description` string, required — A general description of the group
  - `roles` string[]

## Response `200`

OK

- object

---

[API](https://skmtc.dev/orkescloud/apis/orkes-conductor-api-server.md) · [All operations](https://skmtc.dev/orkescloud/apis/orkes-conductor-api-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/orkescloud/orkes-conductor-api-server/revisions/6ebf0c14ac41/schema)