Get cloud task

getCodexCloudTask retrieves the detailed result of one remote task.

automations/get-codex-task.automation.ts

import { automation, onSchedule } from "automate.ax"
import { getCodexCloudTask } from "automate.ax/codex"

export default automation("Inspect Codex task", () => {
  onSchedule({ schedule: "*/5 * * * *" })
  const task = getCodexCloudTask({ taskId: "task_e_abc123" })

  task.status
  task.prompt
  task.attempts[0]!.messages
  task.attempts[0]!.diff
  task.pullRequests[0]!.url
})

The task includes its current state, environment, branch, latest-attempt diff summary, current turn ID, latest prompt, every available assistant attempt, and normalized GitHub pull requests. An attempt includes messages, the complete unified diff, its turn status, error, and attempt number. Optional second argument { account } defaults to the project binding. Output remains empty while the remote turn is pending.

Codex Cloud does not currently provide an official public REST API. This action calls undocumented ChatGPT backend endpoints that may change without notice.

⌘I

Get started

Guides

Concepts

Management API

Reference