> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.rightbrain.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.rightbrain.ai/_mcp/server.

# Model governance

> Exclude models by ID, provider, or vendor; inherit organization policy into projects; and inspect the effective model set through the API.

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:

| Selector   | Effect                                               |
| ---------- | ---------------------------------------------------- |
| `model_id` | Excludes one model UUID.                             |
| `provider` | Excludes every model supplied by the named provider. |
| `vendor`   | Excludes 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.

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

## Organization endpoints

| Action                  | Endpoint                                                 |
| ----------------------- | -------------------------------------------------------- |
| Exclude one model       | `POST /org/{org_id}/model/exclude/by-id`                 |
| Exclude a provider      | `POST /org/{org_id}/model/exclude/by-provider`           |
| Exclude a vendor        | `POST /org/{org_id}/model/exclude/by-vendor`             |
| Remove a rule           | `DELETE /org/{org_id}/model/exclude/{rule_type}/{value}` |
| List organization rules | `GET /org/{org_id}/model/exclusions`                     |

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

## Project endpoints

| Action                   | Endpoint                                                                      |
| ------------------------ | ----------------------------------------------------------------------------- |
| Exclude one model        | `POST /org/{org_id}/project/{project_id}/model/exclude/by-id`                 |
| Exclude a provider       | `POST /org/{org_id}/project/{project_id}/model/exclude/by-provider`           |
| Exclude a vendor         | `POST /org/{org_id}/project/{project_id}/model/exclude/by-vendor`             |
| Remove a project rule    | `DELETE /org/{org_id}/project/{project_id}/model/exclude/{rule_type}/{value}` |
| List project-owned rules | `GET /org/{org_id}/project/{project_id}/model/exclusions`                     |
| Read effective policy    | `GET /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.

## Related

#### [Projects & organizations](/docs/concepts/projects-and-orgs)

Understand resource ownership and permission scope.

#### [Tasks](/docs/concepts/tasks)

Configure a primary and fallback model on a Task revision.

#### [Agents](/docs/concepts/agents)

Configure models on an agent revision.

#### [API Reference: Platform](/api-reference/api-reference/platform)

Read the complete request, response, and error contracts.