---
search:
  tags:
    - administration
    - GET
seo:
  description: >-
    What are Permissions? Permissions are granular access controls that…
    Reference for the GET /administration/permissions endpoint in the Leadtime
    Public API API.
sidebar:
  badge: GET
  label: List available permissions
title: List available permissions
type: openapi-operation
---
**What are Permissions?**
Permissions are granular access controls that determine what actions users can perform. Each permission represents a specific capability like creating tasks, deleting projects, or managing employees.

**What is returned:**
This endpoint returns all available permissions in the system, organized by functional groups:
- **Tasks**: Create, edit, delete, move tasks, manage comments, log time
- **Projects**: Create, edit, delete projects, manage project settings
- **Employees**: Manage employee data, assign roles, view employee information
- **Organizations**: View, create, edit external business partners
- **Roles**: Create, edit, delete custom roles
- **Company**: Manage company settings and workspace configuration
- And many more functional areas

**Permission structure:**
- Each permission has a unique key (e.g., "projects.create", "tasks.delete")
- Permissions are grouped by functional area for easier management
- Permission keys use dot notation: "category.action"

**Use cases:**
- Build permission management interfaces that show all available permissions
- Display permission checkboxes grouped by functional area
- Validate permission keys before assigning them to roles
- Generate permission documentation or help text

<Operation source="api-reference" id="rolescontroller-listpermissions" />
