Fetch tenant policy bundle

GET/tenants/{tenant_id}/policies

Returns the current policy bundle for the tenant, including module entitlements, feature flags, data retention overrides, and any custom governance settings. Use to audit a tenant's configuration or pre-populate the policy editor.

Request

Path parameters

Name	Type	Required	Description
tenant_id	string	Yes	The tenant identifier.

Responses

200 Tenant policy bundle

Content type application/json, object · TenantPolicyBundleV1.

Field	Type	Required	Description
tenant_id	string	No	The tenant this policy bundle applies to (present on responses).
modules	map of boolean	No	Map of module slug to enabled/disabled boolean.
feature_flags	object	No	Map of feature flag key to its value (boolean, string, or integer).
retention	object	No	Data retention override settings.
retention.audit_log_days	integer	No	Number of days to retain audit log entries.
retention.activity_log_days	integer	No	Number of days to retain activity log entries.
updated_at	string (date-time)	No	Timestamp of the last policy bundle update (present on responses).

Example

{
  "tenant_id": "acme",
  "modules": {
    "sales": true,
    "support": true,
    "omnichannel": false,
    "payroll": true
  },
  "feature_flags": {
    "ai_copilot_enabled": true,
    "ewa_enabled": false
  },
  "retention": {
    "audit_log_days": 730,
    "activity_log_days": 365
  },
  "updated_at": "2026-03-01T10:00:00Z"
}

404 Tenant not found

Example request

Paths are relative to the control-plane API base URL ($BASE_URL below).

curl -X GET "$BASE_URL/tenants/{tenant_id}/policies" \
  -H "Accept: application/json"