# Feature Toggle Endpoints {#feature-toggle-endpoints}


Manage feature flags to enable/disable platform features per tenant or organization.


## Base Path {#base-path}


```
/api/feature/toggle
```


## Endpoints {#endpoints}



### List Feature Toggles {#list-feature-toggles}


```
GET /api/feature/toggle
Authorization: Bearer {token}
```


### Get Parent Features {#get-parent-features}


```
GET /api/feature/toggle/parent
Authorization: Bearer {token}
```


### Get Feature Blocks {#get-feature-blocks}


Retrieves all feature blocks (grouped feature flags).

```
GET /api/feature/toggle/blocks
Authorization: Bearer {token}
```


### Update Feature Toggle {#update-feature-toggle}


```
POST /api/feature/toggle/:id
Authorization: Bearer {token}
Content-Type: application/json

{
  "isEnabled": true,
  "organizationId": "uuid"
}
```


## Feature Categories {#feature-categories}


| Feature Code                             | Category | Description                 |
| ---------------------------------------- | -------- | --------------------------- |
| `FEATURE_DASHBOARD`                      | Core     | Dashboard access            |
| `FEATURE_TIME_TRACKING`                  | HRM      | Time tracking module        |
| `FEATURE_ESTIMATE`                       | ERP      | Estimates and quotes        |
| `FEATURE_INVOICE`                        | ERP      | Invoicing module            |
| `FEATURE_INCOME`                         | ERP      | Income tracking             |
| `FEATURE_EXPENSE`                        | ERP      | Expense tracking            |
| `FEATURE_PAYMENT`                        | ERP      | Payment management          |
| `FEATURE_PROPOSAL`                       | ERP      | Proposals                   |
| `FEATURE_PROPOSAL_TEMPLATE`              | ERP      | Proposal templates          |
| `FEATURE_PIPELINE`                       | CRM      | Sales pipelines             |
| `FEATURE_PIPELINE_DEAL`                  | CRM      | Pipeline deals              |
| `FEATURE_ORGANIZATION_CONTACT`           | CRM      | Contacts management         |
| `FEATURE_ORGANIZATION_PROJECT`           | PM       | Project management          |
| `FEATURE_ORGANIZATION_TEAM`              | PM       | Team management             |
| `FEATURE_ORGANIZATION_DOCUMENT`          | Core     | Document management         |
| `FEATURE_ORGANIZATION_EQUIPMENT`         | HRM      | Equipment management        |
| `FEATURE_ORGANIZATION_RECURRING_EXPENSE` | ERP      | Recurring expenses          |
| `FEATURE_EMPLOYEE_TIMESHEET`             | HRM      | Timesheets                  |
| `FEATURE_EMPLOYEE_RECURRING_EXPENSE`     | HRM      | Employee recurring expenses |
| `FEATURE_ORGANIZATION_TAG`               | Core     | Tags management             |
| `FEATURE_EMPLOYEE`                       | HRM      | Employee management         |
| `FEATURE_EMPLOYEE_TIME_ACTIVITY`         | HRM      | Activity monitoring         |
| `FEATURE_JOB`                            | ATS      | Job boards                  |


## Data Model {#data-model}


```typescript
interface IFeature {
  id: string;
  name: string;
  code: string;
  description?: string;
  image?: string;
  link?: string;
  isEnabled: boolean;
  isPaid?: boolean;
  parentId?: string;
  children?: IFeature[];
}

interface IFeatureOrganization {
  id: string;
  isEnabled: boolean;
  featureId: string;
  feature: IFeature;
  organizationId: string;
  tenantId: string;
}
```


## Related Pages {#related-pages}


- [Feature Flags](https://sourcey-gauzy.pages.dev/development/feature-flags/index.md) — development guide
- [Admin Feature Flags](https://sourcey-gauzy.pages.dev/admin/feature-flags/index.md) — admin UI guide