---
title: "Update a share group (add members and share)"
method: PUT
path: "/transact-workflow/v1/users/{userId}/ShareGroup/{shareGroupId}"
tags: ["Share Groups"]
---

# Update a share group (add members and share)

`PUT /transact-workflow/v1/users/{userId}/ShareGroup/{shareGroupId}`

## Request

- Base URL: `https://api.lwolf.com`
- URL: `https://api.lwolf.com/transact-workflow/v1/users/{userId}/ShareGroup/{shareGroupId}`
- Auth: HTTP bearer and API key in header `lw-subscription-key`

Replaces the share group definition, including its member list and the opportunities shared with the group.

## Path parameters

- `userId` string, uuid, required
- `shareGroupId` string, uuid, required

## Request body

- ShareGroupUpdate: Full share group representation used to add members and share opportunities.
  - `shareGroupId` string, uuid: GUID of the share group.
  - `name` string: Display name of the share group.
  - `opportunities` ShareGroupOpportunity[]: Opportunities (transactions) shared with the group.
    - `opportunityId` string, uuid, required: GUID of the shared opportunity (transaction).
  - `members` ShareGroupMember[]: Members of the share group and their permissions.
    - `userId` string, uuid, required: GUID of the member user.
    - `permissionLevel` integer: Permission level code for the member. Observed value: `1`. **TODO: document the full list of code values and their meanings.**
    - `isActive` boolean: Whether the membership is active.

## Response `200`

Successful response

## Other responses

- `400`: The request is malformed or contains invalid parameters.
- `401`: The access token is missing, invalid, or expired.
- `403`: The caller is not permitted to perform this operation.
- `404`: The requested resource does not exist.

---

[API](https://skmtc.dev/lwolf/apis/transact-api.md) · [All operations](https://skmtc.dev/lwolf/apis/transact-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lwolf/apis/transact-api/revisions/9688b0ba3cbc?raw)