Effort

All paths below are relative to the base URL https://api.agentdepot.org — for example GET https://api.agentdepot.org/api/orgs/{org_id}/model-modes. Authenticate with an Authorization: Bearer <token> header. See the REST API reference for details.

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