Get Permissions for Role

Get all permissions assigned directly to a specific role.

caution

This endpoint has been deprecated and will be phased out at the end of 2023. Please update any existing usages of it to use the Query endpoint instead.

Endpoint

GET /v1/roles/:roleId/permissions

Request

cURL

curl "https://api.warrant.dev/v1/roles/admin/permissions" \
    -H "Authorization: ApiKey YOUR_KEY"

Go

rolePermissions, err := permission.ListPermissionsForRole("admin", &warrant.ListPermissionParams{
  ListParams: warrant.ListParams{
    Limit: 100,
  },
})
if err != nil {
    // handle error
}

Java

ListResult<Permission> permissions = client.listPermissionsForRole("admin", new ListParams().withLimit(100));

Node.js

// Class method
const permissions = await warrantClient.Permission.listPermissionsForRole("admin", { limit: 100 });

// Instance method
const role = warrantClient.Role.get("admin");
const permissions = await role.listPermissions({ limit: 100 });

Python

# Class method
role_permissions = warrant.Permission.list_for_role("admin", {"limit": 10})

# Instance method
role = warrant.Role.get("admin")
role_permissions = role.list_permissions({"limit": 10})

Ruby

# Class method
role_permissions = Warrant::Permission.list_for_role("admin", { limit: 10 })

# Instance method
role = Warrant::Role.get("admin")
role_permissions = role.list_permissions({ limit: 10 })

PHP

Response

[
  {
    "permissionId": "create-report"
  }
]