List cloud tasks

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

codex.listCloudTasks returns recent Codex cloud tasks from the connected ChatGPT workspace.

automations/check-codex-tasks.automation.ts

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

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

  // Index the Codex tasks and persist the cursor for the next page.
})

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 codex.unarchiveCloudTask. 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, last update time when reported, status, 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 codex.getCloudTask when you need it. status is pending, ready, applied, error, or unknown when Codex reports a state this integration does not yet recognize.

Built-in triggers

Built-in actions

Runtime utilities

Integrations