get
https://partner.gupshup.io/partner/app//bizai/agent_connectors//logs
Logs are kept 7 days, and one query may span at most 7 days.
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. |
connectorId | string | Yes | Path | Connector id (pfbid). Meta pfbid… id. |
start_time | integer (int64) | No | Query | Unix seconds. Defaults to 24 hours ago. |
end_time | integer (int64) | No | Query | Unix seconds. Defaults to now. |
limit | integer | No | Query | Range 1–1000. Default 100. |
tool_id | string | No | Query | Filter to one tool. Meta pfbid… id. |
include_stats | boolean | No | Query | Include aggregate statistics. |
summary_only | boolean | No | Query | Return aggregated failure patterns only. |
top_n | integer | No | Query | Number of top failure patterns. Range 1–50. Default 10. |
Example request
curl --location --request GET 'https://partner.gupshup.io/partner/app/<appId>/bizai/agent_connectors/<connectorId>/logs?start_time=1789544452&end_time=1789630852&limit=100&include_stats=true&summary_only=false&top_n=10' \
--header 'Authorization: <PARTNER_APP_TOKEN>'Response parameters — 200
200| Parameter | Type | Description |
|---|---|---|
data | array of object | Rows on this page. |
data[].event_time | string (date-time) | When the call happened, ISO 8601. |
data[].failure_code_name | string | Not an exhaustive list. |
data[].error_message | string | Error text. |
data[].tool_name | string | Tool that was called. |
data[].occurrences | integer | How many times this failure occurred. |
data[].last_seen | string | Last occurrence. |
stats | object | Present when include_stats=true. |
stats.start_count | integer | Calls started. |
stats.success_count | integer | Calls that succeeded. |
stats.exception_count | integer | Calls that failed. |
stats.success_rate | number | Share of successful calls, 0–1. |
stats.avg_latency_s | number | Mean latency, seconds. |
stats.p95_latency_s | number | 95th-percentile latency, seconds. |
stats.p99_latency_s | number | 99th-percentile latency, seconds. |
stats.time_window_seconds | integer | Window the stats cover, seconds. |
Example response — 200 OK
200 OK{
"data": [
{
"event_time": "2026-09-24T10:00:00Z",
"failure_code_name": "TRANSPORT_ERROR",
"error_message": "Connection timed out",
"tool_name": "check_order_status",
"occurrences": 6,
"last_seen": "2026-09-24T09:58:12Z"
}
],
"stats": {
"start_count": 120,
"success_count": 114,
"exception_count": 6,
"success_rate": 0.95,
"avg_latency_s": 0.8,
"p95_latency_s": 1.9,
"p99_latency_s": 3.1,
"time_window_seconds": 86400
}
}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.