Org Feature Flag Service
API Contract
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
}
}