# List capabilities

Get all available capabilities with labels, descriptions, and groupings. This is a static endpoint that does not require organization context.

Returns the full list of capabilities that can be assigned to custom roles. Each capability includes a human-readable label, description, and logical grouping.

## Returns

An array of capability metadata objects with `key`, `label`, `description`, and `group` fields.

Request

```bash cURL
curl "https://api.aitronos.com/v1/capabilities" \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```


```python Python SDK
from aitronos import Aitronos

client = Aitronos(api_key="your-api-key")

capabilities = client.capabilities.list()
for cap in capabilities:
    print(f"{cap.key}: {cap.label} ({cap.group})")
```


```python Python
import requests

response = requests.get(
    "https://api.aitronos.com/v1/capabilities",
    headers={"Authorization": "Bearer YOUR_ACCESS_TOKEN"},
)
print(response.json())
```


```javascript JavaScript
const response = await fetch("https://api.aitronos.com/v1/capabilities", {
  headers: { Authorization: "Bearer YOUR_ACCESS_TOKEN" },
});
const capabilities = await response.json();
console.log(capabilities);
```

Response

```json 200 OK
[
  {
    "key": "manage_users",
    "label": "Manage Users",
    "description": "View and edit user profiles and memberships",
    "group": "User Management"
  },
  {
    "key": "invite_users",
    "label": "Invite Users",
    "description": "Send invitations to new users",
    "group": "User Management"
  },
  {
    "key": "deactivate_users",
    "label": "Deactivate Users",
    "description": "Deactivate user accounts within the organization",
    "group": "User Management"
  },
  {
    "key": "remove_users",
    "label": "Remove Users",
    "description": "Remove users from the organization",
    "group": "User Management"
  },
  {
    "key": "manage_departments",
    "label": "Manage Departments",
    "description": "Create, edit, and delete departments",
    "group": "Department Management"
  },
  {
    "key": "manage_roles",
    "label": "Manage Roles",
    "description": "Create, edit, and delete custom roles",
    "group": "Role Management"
  },
  {
    "key": "assign_roles",
    "label": "Assign Roles",
    "description": "Assign and remove roles from users",
    "group": "Role Management"
  },
  {
    "key": "view_audit_log",
    "label": "View Audit Log",
    "description": "View the organization audit log",
    "group": "Audit & Compliance"
  },
  {
    "key": "manage_knowledge_slices",
    "label": "Manage Knowledge",
    "description": "Create, edit, and manage knowledge slices and stores",
    "group": "Knowledge Management"
  },
  {
    "key": "manage_billing",
    "label": "Manage Billing",
    "description": "View and manage billing, subscriptions, and invoices",
    "group": "Billing"
  }
]
```

## Related Resources

- [Create custom role](/docs/api-reference/organizations/roles/create-role)
- [Update custom role](/docs/api-reference/organizations/roles/update-role)
- [Role templates](/docs/api-reference/organizations/roles/role-templates)
- [Effective permissions](/docs/api-reference/organizations/roles/effective-permissions)