---
title: "Update stakeholder group"
method: POST
path: "/stakeholder-comms/cloudId/{cloudId}/api/stakeholder_groups/{groupId}/update"
tags: ["Stakeholder User management"]
---

# Update stakeholder group

`POST /stakeholder-comms/cloudId/{cloudId}/api/stakeholder_groups/{groupId}/update`

Update a stakeholder group for stakeholder communications.

## Path parameters

- `groupId` string, required

## Request body

- StakeholderCommsUpdateStakeholderGroupInput — Request to update a stakeholder group.
  - `name` string — Name of the stakeholder group.
  - `description` string — Description of the stakeholder group.
  - `ownerId` string — Identifier of the group owner.
  - `logoUrl` string — URL of the group logo.
  - `status` 'ACTIVE' | 'INACTIVE' | 'SUSPENDED' | 'DELETED' — Status of the stakeholder group.
  - `insertedAt` string, date-time — When the group was created.
  - `updatedAt` string, date-time — When the group was last updated.
  - `services` string[] — Service identifiers associated with the group.
  - `stakeholders` StakeholderCommsCreateStakeholderInput[] — Stakeholders to add or update in the group.
    - `stakeholder` object, required — Stakeholder creation input.
      - `aaid` string — Atlassian Account ID.
      - `stakeholderType` 'EXTERNAL' | 'INTERNAL' | 'GROUP' | 'TEAM', required — Type of stakeholder.
      - `skipConfirmation` boolean, required — Whether to skip email confirmation.
      - `assignmentType` 'INCIDENT' | 'SITE' | 'ORG' | 'PAGE' | 'PRODUCT' | 'ASSET' | 'SERVICES', required — Type of assignment.
      - `externalAssignmentId` string, required — External assignment identifier.
      - `addedFrom` 'STATUSPAGE' | 'JSM', required — Source system.
      - `emailId` string — Email address.
      - `atlassianTeamId` string — Atlassian team identifier.
      - `stakeholderGroupId` string — Group identifier.
      - `phoneNumber` string — Phone number.
      - `phoneCountry` string — Phone country code.
      - `webhook` string — Webhook URL.
      - `preference` object, required — Notification preferences input.
        - `email` object, required
          - `enabled` boolean
        - `sms` object, required
          - `enabled` boolean
        - `webhook` object, required
          - `enabled` boolean
    - `joiningGroupId` string — Optional group ID to add the stakeholder to.

## Response `200`

Returned if the stakeholder group is successfully updated.

- StakeholderCommsStakeholderGroupResponse — Response containing a single stakeholder group (GET/UPDATE).
  - `group` StakeholderCommsStakeholderGroup — A stakeholder group in Stakeholder Comms.
    - `id` string — Unique identifier of the stakeholder group.
    - `name` string — Name of the stakeholder group.
    - `description` string — Description of the stakeholder group.
    - `ownerId` string — Identifier of the group owner.
    - `logoUrl` string — URL of the group logo.
    - `status` 'ACTIVE' | 'INACTIVE' | 'SUSPENDED' | 'DELETED' — Status of the stakeholder group.
    - `insertedAt` string, date-time — When the group was created.
    - `updatedAt` string, date-time — When the group was last updated.
    - `services` string[] — Service identifiers linked to this group.
  - `error` string — Error message, if the operation was not successful.

## Other responses

- `400` — Returned if the request is invalid.
- `401` — Returned if the authentication credentials are incorrect.
- `403` — Returned if the user does not have permission to update the stakeholder group.
- `404` — Returned if the stakeholder group is not found.
- `500` — Returned if an internal server error occurs.

---

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