Cambrionix connect
Developers
Settings API

Feature flags

Get organization feature flags (public)

GET

/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

200
object
_metadataobject

Metadata for paginated responses. This includes total count, limit, and continuation token.

resultobjectrequired
401

Unauthorized

object
codeintegerrequired

One of: 401

messagestringrequired

One of: "Unauthorized"

detailstringrequired
403

Forbidden: the token is valid but does not allow this request

object
codeintegerrequired
messagestringrequired
detailstringrequired
default

Error

object
codeintegerrequired
messagestringrequired
detailstringrequired

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

PATCH

/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

object
publicOptInsobjectrequired

Responses

200
object
_metadataobject

Metadata for paginated responses. This includes total count, limit, and continuation token.

resultobjectrequired
401

Unauthorized

object
codeintegerrequired

One of: 401

messagestringrequired

One of: "Unauthorized"

detailstringrequired
403

Forbidden: the token is valid but does not allow this request

object
codeintegerrequired
messagestringrequired
detailstringrequired
default

Error

object
codeintegerrequired
messagestringrequired
detailstringrequired

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
  }
}'