Read background Codex job events
codex_job_logsFetch and page through background job events, using a cursor to get only new logs and filtering by event types to reduce noise.
Instructions
Page through the JSONL events of a background run. Pass the returned next_cursor back as "since" to read only what is new. Filter with "types" to cut the noise.
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": {
"job_id": "<job_id>"
},
"name": "codex_job_logs"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum events per page. Defaults to 200. | |
| since | No | Cursor from a previous call. Omit to read from the start. | |
| types | No | Keep only these event types, e.g. ["item.completed", "turn.completed"]. | |
| job_id | Yes | Job id returned by a tool call that went to the background. |