Skip to main content

Flags, scopes and errors

SurfaceRequired gateDefault
Builder routesBUILDER_COHORT_API_ENABLEDfalse
Builder dispatchBUILDER_COHORT_DISPATCH_ENABLEDfalse
OrchestratorCOHORT_PLANNER_MODE + COHORT_DISPATCH_ENABLEDoff + false
NodeSemanticBridge + Memory + Tensor flagsfalse
Console executionNEXT_PUBLIC_FEATURE_COHORTS + endpoint capabilityfalse
Console operational healthsame build flag + account role operator or higherfalse
MCPCOLABHIVE_MCP_COHORT_TOOLS_ENABLED + Builder capabilityfalse

Restrictive API keys need inference:execute. Account role is viewer for read/plan and operator for run/cancel. Empty scopes retain the legacy-key/session contract; Classic routes are unchanged by Cohort enforcement.

The operational health route also requires inference:execute and operator role server-side. The browser does not request it when either UI gate denies access.

Stable error codes include preview_not_enabled, insufficient_scope, endpoint_not_in_rollout, cohort_temporarily_unavailable, no_safe_cohort, cohort_rate_limited, idempotency_conflict and invalid_execution_policy.