List Available Permissions

GET

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

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

Maintainer:Not configured

Returns all available system permissions grouped by resource (e.g. merchants, contests, admins). Use this to populate a permission picker when creating or editing a role. Admin only, requires admins:view.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Responses

🟢200

application/json

Bodyapplication/json

🟠401

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://stageapi.partake.ng/api/v2/admin/roles/permissions' \
--header 'Authorization: Bearer <token>'

Response Example

200 - 200 OK

{
  "success": true,
  "data": [
    {
      "group": "dashboard",
      "permissions": [
        "dashboard:view"
      ]
    },
    {
      "group": "merchants",
      "permissions": [
        "merchants:view",
        "merchants:approve",
        "merchants:suspend",
        "merchants:ban"
      ]
    },
    {
      "group": "users",
      "permissions": [
        "users:view",
        "users:suspend",
        "users:ban"
      ]
    },
    {
      "group": "contests",
      "permissions": [
        "contests:view",
        "contests:approve",
        "contests:cancel",
        "contests:reject",
        "contests:request_changes"
      ]
    },
    {
      "group": "transactions",
      "permissions": [
        "transactions:view",
        "transactions:refund"
      ]
    },
    {
      "group": "logs",
      "permissions": [
        "logs:view"
      ]
    },
    {
      "group": "settings",
      "permissions": [
        "settings:view",
        "settings:manage"
      ]
    },
    {
      "group": "payouts",
      "permissions": [
        "payouts:view",
        "payouts:manage"
      ]
    },
    {
      "group": "admins",
      "permissions": [
        "admins:view",
        "admins:create",
        "admins:manage",
        "admins:manage_tos"
      ]
    },
    {
      "group": "fraud",
      "permissions": [
        "fraud:view",
        "fraud:manage"
      ]
    },
    {
      "group": "webhooks",
      "permissions": [
        "webhooks:view",
        "webhooks:manage"
      ]
    },
    {
      "group": "data_erasure",
      "permissions": [
        "data_erasure:view",
        "data_erasure:manage"
      ]
    }
  ],
  "message": "Permissions retrieved."
}

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

Update Platform Settings

List Roles