Get details of a specific agent run
Learn more about get details of a specific agent run.
Use the Get details of a specific agent run to get the details of a specific agent run. This lets you inspect a single run's outcome and per-entity processing.
HTTP method and endpoint
Use the following HTTP method and endpoint path to get the details of a specific agent run.
GET {TenantURL}/ai/agentflow/api/v202605/{tenant_id}/lrt/jobs/conversation/{conversation_id}/runs/{run_id}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. |
run_id | String | Yes | The unique identifier of the agent run. |
tenant_id | String | Yes | The tenant identifier. |
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/example-id
Authorization: <access_token>Response body
The following table describes the fields returned in the response body.
| Parameter | Type | Description |
|---|---|---|
run_id | String | The unique identifier of the agent run. |
batch_id | Integer | The identifier of the batch that the run belongs to. |
status | String | The status of the run. |
summary | String | The summary text of the run. |
entities_processed | String | The processing state of the entities, as a JSON object. |
entity_ids | Array | The unique identifiers of the entities assigned to this run. |
worker_goal | String | The goal assigned to this run. |
agent_type | String | The type of agent. |
started_at | String | The date and time when the run started. |
updated_at | String | The date and time when the record was last updated. |
agent_name | String | The name of the agent. |
error | String | The error message, if the run failed. |
Example response
The following example shows a response with successful response.
{
"run_id": "<string>",
"batch_id": 0,
"status": "COMPLETED",
"summary": "<string>",
"entities_processed": "<string>",
"entity_ids": [],
"worker_goal": "<string>",
"agent_type": "<string>",
"started_at": "<string>",
"updated_at": "<string>",
"agent_name": "<string>",
"error": "<string>"
}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. |