---
title: "PUT /roles/{id}"
method: PUT
path: "/roles/{id}"
tags: ["roles"]
---

# PUT /roles/{id}

`PUT /roles/{id}`

## Path parameters

- `id` integer, required

## Request body

- object
  - `name` string
  - `description` string

## Response `202`

role

- object
  - `message` string
  - `data` Role
    - `id` integer
    - `name` string
    - `description` string

## Other responses

- `404` — no content to display
- `500` — internal server error

## Changes

- **2025-08-07** `8f39d60f160a` — 1 breaking, 3 info
  - the `data` response's property type/format changed from ``/`` to `object`/`` for status `202`
  - added the optional property `data/description` to the response with the `202` status
  - added the optional property `data/id` to the response with the `202` status
  - added the optional property `data/name` to the response with the `202` status
- **2025-01-22** `ed48b7196725` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/verifywise-ai/apis/verifywise-api/changes/roles/:id/put.md)

---

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