List all agent runs for a conversation

Learn more about list all agent runs for a conversation.

Use the List all agent runs for a conversation to list all agent runs for a conversation. This lets you review every run in a conversation and drill into the one you need.

HTTP method and endpoint

Use the following HTTP method and endpoint path to list all agent runs for a conversation.

GET {TenantURL}/ai/agentflow/api/v202605/{tenant_id}/lrt/jobs/conversation/{conversation_id}/runs

The following table describes the endpoint path parameters.


Parameter	Type	Required	Description
`TenantURL`	String	Yes	The base URL for your tenant.
`conversation_id`	String	Yes	The unique identifier of the conversation associated with the job.
`tenant_id`	String	Yes	The tenant identifier.

Query parameters

The following table describes the query parameters and their values.


Parameter	Type	Required	Description	Accepted values / Default
`limit`	Integer	No	The maximum number of runs to return per page.	Default: `50`
`page_token`	String	No	The page token from a previous response. Omit to get the first page.	—

Request headers

The following request headers must be included.


Header	Value	Required
`Authorization`	`<access_token>`	Yes

Request body

This operation does not require a request body.

Example request

Use the following example to see how a complete request is structured, with headers.

GET {TenantURL}/ai/agentflow/api/v202605/tenant-xyz/lrt/jobs/conversation/example-id/runs
Authorization: <access_token>

Response body

The following table describes the fields returned in the response body.


Parameter	Type	Description
`runs`	Array	The runs in this page of results.
`runs[].run_id`	String	The unique identifier of the agent run.
`runs[].batch_id`	Integer	The identifier of the batch that the run belongs to. Use with run_id to get the run details.
`runs[].status`	String	The status of the run.
`runs[].agent_type`	String	The type of agent (for example WORKER or SUPERVISOR).
`runs[].worker_goal`	String	The goal assigned to this run.
`runs[].entity_ids`	Array	The unique identifiers of the entities assigned to this run.
`runs[].started_at`	String	The date and time when the run started.
`runs[].updated_at`	String	The date and time when the record was last updated.
`runs[].agent_name`	String	The name of the agent.
`pagination`	Object	Pagination details for this page of results.
`pagination.total_count`	Integer	The number of items in this page of results.
`pagination.next_page_token`	String	The token to pass as page_token to get the next page of results. Empty when this is the last page.
`pagination.limit`	Integer	The maximum number of items per page.

Example response

The following example shows a response with successful response.

{
  "runs": [
    {
      "run_id": "<string>",
      "batch_id": 0,
      "status": "COMPLETED",
      "agent_type": "<string>",
      "worker_goal": "<string>",
      "entity_ids": [],
      "started_at": "<string>",
      "updated_at": "<string>",
      "agent_name": "<string>"
    }
  ],
  "pagination": {
    "total_count": 50,
    "next_page_token": "eyJvZmZzZXQiOiA1MH0=",
    "limit": 50
  }
}

Error codes and recommended actions

The following table lists the possible error responses returned by this API.


HTTP status	Description	Recommended action
`422 Unprocessable Entity`	Validation Error	Review the request parameters or body, correct the invalid values, and resend the request.

Unify and manage your data