---
title: "Update document group template role"
method: PUT
path: "/v2/document-group-templates/{document_group_template_id}/roles/{user_id}"
---

# Update document group template role

`PUT /v2/document-group-templates/{document_group_template_id}/roles/{user_id}`

## Request

- Base URL: `https://api.signnow.com`
- URL: `https://api.signnow.com/v2/document-group-templates/{document_group_template_id}/roles/{user_id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/signnow/apis/signnow-api/docs/v2/document-group-templates/:document_group_template_id/roles/:user_id/put.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint allows the owner of a document group template to change the role of a user who already has sharing access.

**Notes**

* Only the owner of the document group template can change roles.
* The user must already have a role assigned (i.e., the template must be shared with them first).

## Request body

- object
  - `role` string, required: New role to assign. Allowed values: `viewer`, `sender`.

## Response `200`

Role successfully updated.

- object
  - `id` string: Unique identifier of the user.
  - `role` string: User's new role in the document group template (e.g., `viewer`, `sender`).
  - `email` string: Email address of the user.

## Other responses

- `400`: Bad request. Possible errors: * Document group template not found. * User role not found. * Role validation errors.
- `401`: Incorrect or missing bearer token.
- `403`: Forbidden. You don't have access to the document group template.

---

[API](https://skmtc.dev/signnow/apis/signnow-api.md) - [All operations](https://skmtc.dev/signnow/apis/signnow-api/llms.txt) - [OpenAPI document](https://skmtc.dev/signnow/apis/signnow-api/revisions/1c9c30a6142b?raw)