List cloud environments

listCodexCloudEnvironments returns the Codex cloud environments available to the connected ChatGPT workspace.

automations/list-codex-environments.automation.ts

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

export default automation("List Codex environments", () => {
  onSchedule({ schedule: "0 9 * * 1" })
  const environments = listCodexCloudEnvironments({})

  environments[0]!.id
  environments[0]!.label
})

Each environment includes its stable id, display label, isPinned state, and current taskCount. Pass the ID to startCodexCloudTask or listCodexCloudTasks. Optional second argument { account } defaults to the project binding.

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

List cloud environments