List cloud tasks

listCodexCloudTasks returns recent Codex cloud tasks from the connected ChatGPT workspace.

automations/check-codex-tasks.automation.ts

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

export default automation("Check Codex tasks", () => {
  onSchedule({ schedule: "*/5 * * * *" })
  const page = listCodexCloudTasks({
    environmentId: "env_abc123",
    filter: "current",
    limit: 10,
  })

  page.tasks
  page.cursor
})

Connect a Codex access token. environmentId optionally filters the results to one configured environment. filter accepts current, archived, or all and defaults to current; use archived to find a task before restoring it with unarchiveCodexCloudTask. limit accepts 1 through 20 and defaults to 20. Pass a previous cursor to retrieve the next page. Optional second argument { account } defaults to the project binding. Each task includes its ID, ChatGPT URL, title, status, last update time, branch, environment label, archive state, attempt count, pull requests, and the latest attempt’s changed-file and line counts. The list endpoint does not report a stable environment ID, so environmentId is null; use getCodexCloudTask when you need it. status is pending, ready, applied, or error.

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