List roles

Retrieve a paginated list of roles defined within a specific organization. This endpoint provides access to role information including permissions, member assignments, and role hierarchy. Roles can be filtered and sorted by various criteria.

GET
/organizations/{organizationId}/roles

Authorization

AuthorizationBearer <token>

In: header

Path Parameters

organizationId*string

Unique identifier of the organization

Query Parameters

id?string

Filter resources by their unique identifier

name?string

Filter resources by their name or title

autocomplete?string

Search term for autocomplete functionality

limit?integer

How many items to return at one time (max 100)

Formatint64
next?string

Pagination token for retrieving the next page of results

order?string

Sort order for the results (ascending or descending)

Value in"asc" | "desc"
sortBy?string

Field name to sort the results by

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://api-testnet.dual.network/organizations/string/roles"
{
  "next": "string",
  "roles": [
    {
      "id": "string",
      "name": "string",
      "description": "string",
      "permissions": [
        {
          "resource": "api-keys",
          "crud": {
            "read": true,
            "create": true,
            "update": true,
            "delete": true
          }
        }
      ],
      "when_created": "2019-08-24T14:15:22Z",
      "when_modified": "2019-08-24T14:15:22Z"
    }
  ]
}
{
  "code": 0,
  "message": "string",
  "details": {}
}
{
  "code": 0,
  "message": "string",
  "details": {}
}
{
  "code": 0,
  "message": "string",
  "details": {}
}