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

​
Path Parameters

​
organizationId
string
required
Organization ID

​
Query Parameters

​
page
number
Page number (default: 1)
​
limit
number
Items per page (default: 20)
​
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": {
    "page": 1,
    "limit": 20,
    "total": 5,
    "pages": 1
  }
}

​
Code Examples

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