Get cloud task

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

codex.getCloudTask retrieves the detailed result and complete turn history of one remote task.

automations/get-codex-task.automation.ts

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

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

  // Publish the task's complete turn history, diffs, and pull requests.
})

The task includes its current state, environment, branch, latest-attempt diff summary, current turn ID, latest prompt, complete turns history, and normalized GitHub pull requests. Each turn contains its user prompt and every assistant attempt. An attempt includes messages, the complete inline unified diff, its turn status, error, and attempt number. Top-level attempts contains the current turn’s attempts for convenient result handling. Optional second argument { account } defaults to the project binding. Task status is pending, ready, applied, error, or unknown. unknown preserves a new provider state so an automation does not wait forever after the backend contract changes.

Built-in triggers

Built-in actions

Runtime utilities

Integrations