---
title: "Update role"
method: PUT
path: "/roles/{name}"
tags: ["roles"]
---

# Update role

`PUT /roles/{name}`

Updates an existing role

## Request body

- Role
  - `id` integer
  - `name` string — name is unique
  - `description` string — optional description
  - `created_at` integer — creation time as unix timestamp in milliseconds
  - `updated_at` integer — last update time as unix timestamp in milliseconds
  - `users` string[] — list of usernames associated with this group
  - `admins` string[] — list of admins usernames associated with this group

## Response `200`

successful operation

- ApiResponse
  - `message` string — message, can be empty
  - `error` string — error description if any

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error
- `default` — Unexpected Error

---

[API](https://skmtc.net/kanton-bern/apis/sftpgo.md) · [All operations](https://skmtc.net/kanton-bern/apis/sftpgo/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kanton-bern/sftpgo/versions/d8d616a479b0/schema)