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

# Update a role

`PUT /roles/{id}`

Update role details (name, hierarchy priority, min_topup)

## Path parameters

- `id` number, required

## Request body

- UpdateRoleDto
  - `role_name` 'admin' | 'marketing' | 'customer support' | 'operation' — Role name (admin, marketing, customer support, operation)
  - `hierarchy_priority` number — Hierarchy priority (lower number = higher priority)
  - `min_topup` number — Minimum topup amount for this role (optional)

## Response `200`

Role updated successfully

- RoleResponseDto
  - `role_id` number, required — Role ID
  - `role_name` string, required — Role name
  - `hierarchy_priority` number, required — Hierarchy priority
  - `min_topup` number, nullable — Minimum topup amount

## Other responses

- `400` — Bad Request
- `404` — Role not found
- `409` — Role name already exists

---

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