codex_start
Starts a persistent Codex conversation and immediately returns a task ID; then poll codex_events and handle pending requests until the turn completes.
Instructions
Start a persistent Codex conversation and return promptly with a task id. Poll codex_events and handle pending_requests until the turn finishes.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | ||
| model | No | ||
| access | No | write | |
| effort | No | ||
| images | No | ||
| prompt | Yes | ||
| skills | No | ||
| workdir | No | Absolute project directory chosen by the main agent | |
| project_id | No | Selected project; use instead of workdir | |
| request_id | No | Key for identical retries | |
| operation_id | No | Alias of request_id | |
| service_tier | No | ||
| approval_mode | No | Native Codex reviewer; approve_for_me uses auto_review without disabling sandboxing | inherit |
| context_files | No | ||
| output_schema | No | ||
| collaboration_mode | No | default |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| result_version | Yes |