Create Role

POST

https://stageapi.partake.ng/api/v2/admin/roles

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

Maintainer:Not configured

Creates a custom admin role with a set of 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

🟢201

application/json

Bodyapplication/json

🟠409

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://stageapi.partake.ng/api/v2/admin/roles' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "name": "finance_admin",
  "displayName": "Finance Admin",
  "description": "Manages financial oversight.", // optional
  "permissions": ["transactions:view"]
}'

Response Example

201 - 201 Created

{
  "success": true,
  "data": {
    "id": "role-uuid-003",
    "name": "finance_admin",
    "displayName": "Finance Admin",
    "isSystem": false
  },
  "message": "Role created."
}

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

List Roles

Get Role Detail