get
https://partner.gupshup.io/partner/app//bizai/agent-eval/run
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Request parameters
| Parameter | Type | Required | In | Description |
|---|---|---|---|---|
Authorization | string | Yes | Header | Partner app token, sent raw. Bearer <token> is also accepted. |
appId | string (uuid) | Yes | Path | Partner Portal app id. Stands in for Meta's entity_id. |
job_id | string | Yes | Query | Job id from POST /agent-eval/run. |
Example request
curl --location --request GET 'https://partner.gupshup.io/partner/app/<appId>/bizai/agent-eval/run?job_id=pfbid0EvalJobExampleId' \
--header 'Authorization: <PARTNER_APP_TOKEN>'Response parameters — 200
200| Parameter | Type | Description |
|---|---|---|
status | string | One of: QUEUED, RUNNING, COMPLETED, FAILED. |
progress | object | How far the run has got. |
progress.completed | integer | Cases finished. |
progress.total | integer | Cases in the run. |
progress.current_stage | string | One of: simulation, evaluation, insights, done. |
result | object | Present when COMPLETED. |
result.id | string | Resource id. |
result.summary_id | string | Summary id, for GET /agent-eval/summary. |
result.avg_conversation_score | number | Range 1–5. |
result.avg_turn_score | number | Range 1–5. |
result.summary | string | Narrative summary. |
result.highlights | string | JSON string |
result.top_failure_categories | string | JSON string |
result.eval_ids_by_score | string | JSON string |
result.creation_time | integer | Creation time, Unix seconds. |
result.update_time | integer | Last update time, Unix seconds. |
error | object | Present when FAILED. |
error.code | string | e.g. SIMULATION_FAILED. |
error.message | string | The outbound message as sent. |
error.failed_case_ids | array of string | Cases that failed. |
Example response — 200 OK
200 OK{
"status": "COMPLETED",
"progress": {
"completed": 2,
"total": 2,
"current_stage": "done"
},
"result": {
"summary_id": "pfbid0SummaryExampleId",
"avg_conversation_score": 4.2,
"avg_turn_score": 4.4,
"summary": "Agent resolved most refund requests; escalations were slow.",
"highlights": "[\"Fast first response\"]",
"top_failure_categories": "[\"missing_context\"]",
"eval_ids_by_score": "{\"4\": [\"pfbid0EvaluationExampleId\"]}",
"creation_time": 1789630852,
"update_time": 1789631152
}
}Error responses
400 Bad Request — The app is not live, or WASS does not consider it live.
{
"message": "App is not live.",
"status": "error"
}400 Bad Request — The app has no phone number attached. Checked before the live check.
{
"message": "Phone id not found for the given App",
"status": "error"
}401 Unauthorized — Authorization is missing or invalid, belongs to another app, or appId is unknown or not a UUID.
{
"status": "error",
"message": "Unauthorised access to the resource. Please review request parameters and headers and retry"
}405 Method Not Allowed — Any method other than GET, POST, PUT or DELETE, e.g. PATCH.
{
"status": "error",
"message": "Request method 'PATCH' is not supported"
}429 Too Many Requests — More than 30 /bizai/** requests in 60 seconds for this app. The 31st is rejected.
{
"status": "error",
"message": "Too Many Requests"
}Per-app rate limit exceeded. Retry after the 60-second window.