REST /api/v1/org-feature-flags 7 endpoints
GET /api/v1/org-feature-flags/api/v1/org-feature-flags

List feature flag states across all organisations (admin)

Public

Response Example

{
  "data": [
    {
      "org_id": "org_812",
      "feature_key": "driver_declarations",
      "enabled": true,
      "updated_at": "2026-02-01T00:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 34
  }
}
GET /api/v1/org-feature-flags/api/v1/org-feature-flags/:org_id

Get all feature flags for a specific organisation

Public

Response Example

{
  "org_id": "org_812",
  "flags": {
    "driver_declarations": true,
    "encrypted_storage": true,
    "sms_reminders": false,
    "multi_template": false
  },
  "refreshed_at": "2026-03-26T08:00:00Z"
}
POST /api/v1/org-feature-flags/api/v1/org-feature-flags

Create feature flag configuration for a new organisation

Public

Request Example

{
  "org_id": "org_999",
  "feature_key": "driver_declarations",
  "enabled": true
}

Response Example

{
  "org_id": "org_999",
  "feature_key": "driver_declarations",
  "enabled": true,
  "created_at": "2026-03-26T09:00:00Z"
}
PUT /api/v1/org-feature-flags/api/v1/org-feature-flags/:org_id

Update feature flag settings for an organisation

Public

Request Example

{
  "feature_key": "driver_declarations",
  "enabled": false
}

Response Example

{
  "org_id": "org_812",
  "feature_key": "driver_declarations",
  "enabled": false,
  "updated_at": "2026-03-26T10:00:00Z"
}
DELETE /api/v1/org-feature-flags/api/v1/org-feature-flags/:org_id

Remove all feature flag overrides for an organisation (resets to defaults)

Public

Response Example

{
  "org_id": "org_812",
  "deleted": true,
  "deleted_at": "2026-03-26T11:00:00Z"
}
GET /api/v1/org-feature-flags/api/v1/org-feature-flags/:org_id/:feature_key

Check whether a specific feature is enabled for an organisation

Public

Response Example

{
  "org_id": "org_812",
  "feature_key": "driver_declarations",
  "enabled": true
}
POST /api/v1/org-feature-flags/api/v1/org-feature-flags/:org_id/refresh

Force refresh of cached feature flags for an organisation

Public

Response Example

{
  "org_id": "org_812",
  "refreshed_at": "2026-03-26T09:05:00Z",
  "flags": {
    "driver_declarations": true,
    "encrypted_storage": true
  }
}

Additional Metadata

{
  "contract_summary": {
    "total_contracts": 410,
    "total_endpoints": 2416,
    "api_styles_used": [
      "rest"
    ]
  },
  "generated_at": "2026-03-26T06:55:53.316Z"
}