List cloud environments

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

codex.listCloudEnvironments returns the Codex cloud environments available to the connected ChatGPT workspace.

automations/list-codex-environments.automation.ts

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

export default automation("List Codex environments", () => {
  onSchedule({ schedule: "0 9 * * 1" })
  const page = codex.listCloudEnvironments({ limit: 20 })

  // Store the environment IDs for later Codex task submissions.
})

Each environment includes its stable id, display label, isPinned state, and current taskCount. limit accepts 1 through 50 and defaults to 50. Pass cursor from one result to retrieve the next page. Pass an environment ID to codex.startCloudTask or codex.listCloudTasks. Optional second argument { account } defaults to the project binding.

Built-in triggers

Built-in actions

Runtime utilities

Integrations

List cloud environments