---
title: "Update role for template"
method: PUT
path: "/v2/templates/{template_id}/roles/{user_id}"
---

# Update role for template

`PUT /v2/templates/{template_id}/roles/{user_id}`

## Request

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

This endpoint allows API users to change a user's role for a shared template. 

**Note**: Only the template owner can make role changes.

## Request body

- object
  - `role` string, required: The role assigned to the user. Allowed values are `sender` and `viewer`.

## Response `200`

Successful response.

- object
  - `id` string: ID of the user.
  - `role` string: New role of the user for the template: `viewer` or `sender`.
  - `email` string: Email address of the user.

## Other responses

- `400`: * Wrong, expired, or missing token. * The template doesn't exist. * You are not the template owner. * The user with `user_id` doesn't have a role in the template. * `role` must be one of: `viewer`, `sender`.

---

[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)