Retrieves the current status and results of a specific agent run. Use the run id returned in data.id by Start Agent Run or the first event of a streaming run by Start Agent Run (Stream).

By default, the endpoint returns the run's current state immediately. Set returnImmediately=false to wait for the run to reach a terminal state. Requests that remain open can wait for up to 300 seconds. If the request times out before the run completes, the response returns the in-progress run and execution continues in the background. Call this endpoint again with the same run id to retrieve the latest status and results.

When the run completes, the first item in artifacts contains the primary response and may include text and structured data. Additional artifacts, when present, contain supplementary output.

For agents that support streaming, use Resume Agent Run Stream to follow the run in real time.