Get Agent Run

Fetch one dispatched AI agent run with its owning task’s name, the full stored outcome summary (the list clips it), and tool_iterations - the tool calls the run’s linked session made, or null when no session is attached. turns_used counts sessions, not tool calls.

GET /api/v1/org/ai-agent-runs/{run_id}

Get Agent Run

Python

import requests

url = "https://platform.ankra.app/api/v1/org/ai-agent-runs/{run_id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

200

{
  "ai_session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "finished_at": "2023-11-07T05:31:56Z",
  "goal_status": "<string>",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "outcome_summary": "<string>",
  "started_at": "2023-11-07T05:31:56Z",
  "status": "<string>",
  "task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "task_name": "<string>",
  "tool_iterations": 123,
  "trigger_context": "<unknown>",
  "turns_used": 123
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

authorization · string | null

x-ankra-organisation-id · string | null

Path Parameters

run_id · string<uuid> · required

Response

200

application/json

Successful Response

ai_session_id · string<uuid> | null

finished_at · string<date-time> | null

goal_status · string | null

id · string<uuid>

outcome_summary · string | null

started_at · string<date-time>

status · string

task_id · string<uuid>

task_name · string

tool_iterations · integer | null

trigger_context · any

turns_used · integer