Feature flags
Get organization feature flags (public)
/settings/v1/feature-flags
Returns public opt-ins and server-derived eligibility and effective flags. Private rollout keys are never included. The caller must hold both Organization.Settings.FeatureFlags.Read and Organization.Subscriptions.Read; the response is a single document (not field-level auth). Eligibility reflects the internal rollout allowlist; effective usage-based billing is rollout plus public opt-in only, while hub license subscriptions are a private admin toggle. License and billing preconditions are enforced on consuming services.
Requires a bearer access token for this API with the Organization.Settings.FeatureFlags.Read, Organization.Subscriptions.Read permissions. See Authentication.
Responses
Metadata for paginated responses. This includes total count, limit, and continuation token.
Unauthorized
One of: 401
One of: "Unauthorized"
Forbidden: the token is valid but does not allow this request
Error
Try it
curl -X GET "https://connect.cambrionix.com/api/settings/v1/feature-flags" \ -H "Authorization: Bearer $CONNECT_ACCESS_TOKEN"
Update public organization feature flags
/settings/v1/feature-flags
Updates allowlisted public opt-ins. Requires both Organization.Settings.FeatureFlags.Write and Organization.Subscriptions.Update. Usage-based billing opt-in requires an active rollout allowlist (private allowlist) in addition to these permissions.
Requires a bearer access token for this API with the Organization.Settings.FeatureFlags.Write, Organization.Subscriptions.Update permissions. See Authentication.
Request body
Responses
Metadata for paginated responses. This includes total count, limit, and continuation token.
Unauthorized
One of: 401
One of: "Unauthorized"
Forbidden: the token is valid but does not allow this request
Error
Try it
curl -X PATCH "https://connect.cambrionix.com/api/settings/v1/feature-flags" \ -H "Authorization: Bearer $CONNECT_ACCESS_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "publicOptIns": { "hostComputerEndpointUsage": true, "usageBasedBilling": true } }'