Skip to main content

Get Phoenix Run Status

Check the status and details of a Phoenix agent run started by phoenix_invoke_agent. Returns the current status (queued | running | succeeded | partially_failed | failed), any generated artifacts (with absolute URLs), the agent name, inputs, timestamps, and credit cost. Use this once the user asks whether their run/brief is done, or to grab the artifact link after a run succeeds. If the run is still queued or running, return the status and run id to the user rather than calling this tool again in a loop; repeated polling within one turn will exhaust the step budget. Do NOT use this to start a run — use phoenix_invoke_agent; to browse every deliverable the org has (not just one run) use phoenix_list_artifacts, and to inline one artifact's HTML body use phoenix_get_artifact.

Parameters​

NameTypeRequiredDefaultDescription
run_idstring✅ Yes-The run id to check (UUID). This is the runId returned by phoenix_invoke_agent.

Use Cases​

  • Check whether a previously started agent run has finished
  • Retrieve the artifact URL after a run succeeds
  • Report a run's credit cost (tool + LLM credits) back to the user
  • Confirm a run failed and surface the failure status

Example Usage​

Check a run by its id

{
  "tool": "phoenix_get_run_status",
  "arguments": {
    "run_id": "00000000-0000-0000-0000-000000000000"
  }
}

phoenix_invoke_agent, phoenix_list_agents, phoenix_get_artifact, phoenix_list_artifacts