Production Controls

Model governance

Control which models can be selected in an organization or project.

Model availability rules restrict which models can be selected for Tasks and agents. Rules can apply to one project or to every project in an organization.

Rule scopes

An organization rule is inherited by every project in that organization. A project cannot override it.

A project rule applies only to that project. The effective policy is the union of its project rules and inherited organization rules.

Use organization rules for controls that must be consistent across teams. Use project rules for workload-specific restrictions.

Selectors

Rules support three selectors:

SelectorEffect
model_idExcludes one model UUID.
providerExcludes every model supplied by the named provider.
vendorExcludes every model served by the named vendor.

Provider and vendor rules also apply to models added later that match the selector. Each rule can carry an audit reason.

Rightbrain rejects a rule that would leave an affected project without at least one active model.

Organization endpoints

ActionEndpoint
Exclude one modelPOST /org/{org_id}/model/exclude/by-id
Exclude a providerPOST /org/{org_id}/model/exclude/by-provider
Exclude a vendorPOST /org/{org_id}/model/exclude/by-vendor
Remove a ruleDELETE /org/{org_id}/model/exclude/{rule_type}/{value}
List organization rulesGET /org/{org_id}/model/exclusions

Organization rule operations require organization edit access. The list response is a plain array.

Project endpoints

ActionEndpoint
Exclude one modelPOST /org/{org_id}/project/{project_id}/model/exclude/by-id
Exclude a providerPOST /org/{org_id}/project/{project_id}/model/exclude/by-provider
Exclude a vendorPOST /org/{org_id}/project/{project_id}/model/exclude/by-vendor
Remove a project ruleDELETE /org/{org_id}/project/{project_id}/model/exclude/{rule_type}/{value}
List project-owned rulesGET /org/{org_id}/project/{project_id}/model/exclusions
Read effective policyGET /org/{org_id}/project/{project_id}/model/exclusions/effective

Project rule operations require project edit access. Project-owned rule lists are plain arrays.

The effective response separates organization_rules from project_rules and reports excluded and available counts across active models.

Model IDs

Model-specific rules use the UUID returned by GET .../model. Task and agent configuration also uses a model UUID in llm_model_id; a display name is not a substitute for this identifier.

Projects & organizations

Understand resource ownership and permission scope.

Tasks

Configure a primary and fallback model on a Task revision.

Agents

Configure models on an agent revision.

API Reference: Platform

Read the complete request, response, and error contracts.