Get workspace agent run

getChatGPTWorkspaceAgentRun gets the latest status for a run started by triggerChatGPTWorkspaceAgent.

automations/get-chatgpt-agent-run.automation.ts

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

export default automation("Check ChatGPT agent", () => {
  onSchedule({ schedule: "*/5 * * * *" })
  const run = getChatGPTWorkspaceAgentRun({
    apiTriggerId: "agtch_engineering_123",
    runId: "apirun_123",
  })

  run.status
  run.conversationUrl
})

Pass the same apiTriggerId used to start the run and its returned runId. Optional second argument { account } defaults to the project binding. The result includes the published agent and trigger IDs, ChatGPT conversation URL, creation time, current status, and nullable failure details. status is queued, in_progress, suspended, completed, or failed. Only completed and failed are terminal. A suspended run is waiting for an external action or tool. Failed runs report dispatch_failed or run_failed in error.code.

⌘I

Get started

Guides

Concepts

Management API

Reference

Get workspace agent run