codex_settings
Read and update Codex task settings—model, effort, approval and collaboration modes, service tier, access, and family budgets—using operation keys for safe retries.
Instructions
get reads settings. next takes model/effort/approval_mode/collaboration_mode/service_tier/access and root-only family budget (applies now; {} clears). current takes model/effort/approval_mode/service_tier and expected_turn_id. Changes need an operation key.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"task_id": "<task_id>"
},
"name": "codex_settings"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | No | ||
| scope | No | get | |
| access | No | ||
| budget | No | Family lifetime limits: server turns/child admissions hard; active seconds, tokens, stored bytes soft (may overshoot). Native continuations/children may exceed admission caps. {} clears. | |
| effort | No | ||
| task_id | Yes | Task id | |
| request_id | No | Key for identical retries | |
| operation_id | No | Alias of request_id | |
| service_tier | No | ||
| approval_mode | No | ||
| expected_turn_id | No | ||
| collaboration_mode | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| result_version | Yes |