Update user (ban, role change)

Designing

Staging

https://staging.syncode.anggita.org/api

PATCH

/admin/users/{id}

Admin

Updates a user's role or ban status. When banning a user, bannedReason is required. Banning immediately invalidates all refresh tokens.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Updated user

Body

🟠400Bad Request

🟠403Forbidden

🟠404Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH 'https://staging.syncode.anggita.org/api/admin/users/' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "role": "user",
    "isBanned": true,
    "bannedReason": "string"
}'

Response Example

200 - Example 1

{
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "username": "string",
    "email": "user@example.com",
    "displayName": "string",
    "role": "user",
    "isBanned": true,
    "bannedReason": "string",
    "totalSessions": 0,
    "lastActiveAt": "2019-08-24T14:15:22.123Z",
    "createdAt": "2019-08-24T14:15:22.123Z"
}

Modified at 2026-03-11 21:12:01

Get user details (admin view)

List all rooms