codex_goal
Read, set, or clear a task goal—including objective, status, and token budget—while requiring explicit user approval and an operation key for changes.
Instructions
get reads a goal; set takes objective/status/token_budget; clear removes it. Mutations need user_requested=true and an operation key. Only change goals on explicit human instruction.
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_goal"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | No | get | |
| status | No | ||
| task_id | Yes | Task id | |
| objective | No | ||
| request_id | No | Key for identical retries | |
| operation_id | No | Alias of request_id | |
| token_budget | No | ||
| user_requested | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| result_version | Yes |