Effort
GET /api/orgs/{org_id}/model-modes
Section titled “GET /api/orgs/{org_id}/model-modes”List Model Modes
The effort levels this org may pick, with each level’s credit burn ratio.
Member-level: choosing a level is an ordinary chat-composer action, and the agent form is already gated separately on admin/owner.
direct_model_choice tells the caller which of the two selection UIs
applies. It comes from :class:EntitlementService, so an org with no
subscription resolves to False — effort levels — which is the state that
still yields a working run. Note that this is the only entitlement in
play: the level list itself is the platform’s, identical for every plan.
The ratios are derived on every call from live catalog prices, so they
cannot drift from what the ledger will actually charge. A level with no
configured preset, or one whose models the catalog cannot price, reports
burn_ratio: null.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| org_id | path | string (uuid) | yes |
Responses
| Status | Description | Body |
|---|---|---|
| 200 | Successful Response | EffortLevelsResponse |
| 422 | Validation Error | HTTPValidationError |