Skip to main content
GET
/
app
/
v1
/
organizations
/
{organizationId}
/
roles
List Roles
curl --request GET \
  --url https://api.example.com/app/v1/organizations/{organizationId}/roles

Documentation Index

Fetch the complete documentation index at: https://docs.metabind.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Path Parameters

​
organizationId
string
required
Organization ID

​
Query Parameters

​
limit
number
Items per page (default: 20)
​
lastKey
string
Cursor for pagination (from previous response)
​
search
string
Search term for name/description

​
Response

Returns a paginated list of Role objects. 
{
  "data": [
    {
      "id": "role123",
      "name": "editor",
      "description": "Content management with publishing rights",
      "permissions": {
        "organizations": { "read": true, "update": false, "delete": false },
        "projects": { "create": false, "read": true, "update": false, "delete": false },
        "content": { "create": true, "read": true, "update": true, "publish": true, "delete": true },
        "assets": { "create": true, "read": true, "update": true, "delete": true }
      },
      "createdAt": "2024-03-20T10:00:00Z",
      "updatedAt": "2024-03-20T10:00:00Z"
    }
  ],
  "pagination": {
    "lastKey": "role456"
  }
}

​
Code Examples

curl -X GET "https://api.metabind.ai/app/v1/organizations/org123/roles" \
  -H "Authorization: Bearer YOUR_JWT"