Update Role

PATCH

https://stageapi.partake.ng/api/v2/admin/roles/{{roleId}}

Last modified:2026-07-10 13:15:30

Maintainer:Not configured

Updates role displayName, description, or permissions. Admin only.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/json

Examples

Responses

🟢200

application/json

Bodyapplication/json

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff --request PATCH 'https://stageapi.partake.ng/api/v2/admin/roles/{{roleId}}' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "permissions": [
        "dashboard:view",
        "merchants:view",
        "merchants:approve",
        "merchants:suspend",
        "merchants:ban",
        "users:view",
        "users:suspend",
        "users:ban",
        "contests:view",
        "contests:approve",
        "contests:cancel",
        "transactions:view",
        "transactions:refund",
        "logs:view",
        "settings:view",
        "settings:manage",
        "admins:view",
        "admins:create",
        "admins:manage",
        "contests:reject",
        "contests:request_changes"
    ]
}'

Response Example

200 - 200 OK

{
  "success": true,
  "data": {"id": "role-uuid-002", "displayName": "Finance Manager", "permissions": ["transactions:view"]},
  "message": "Role updated."
}

Modified at 2026-07-10 13:15:30

Get Role Detail

Delete Role