List connector error logs

Retrieve error logs for the connector. Returns individual log entries by default, or aggregated failure patterns when summary_only is true. Optionally includes aggregate statistics. Only third-party errors are included. The time range must not exceed 7 days and logs are available for the last 7 days only.

get

Authorizations

D360-API-KEY

D360-API-KEYstringRequired

API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.

Path parameters

connector_idstringRequired

The unique identifier of the connector

Query parameters

start_timeintegerOptional

Start of the time range (Unix seconds). Defaults to 24 hours ago. Must be within the last 7 days.

end_timeintegerOptional

End of the time range (Unix seconds). Defaults to now.

limitintegerOptional

Maximum number of log entries to return (1-1000). Defaults to 100.

tool_idstringOptional

Optional tool ID to filter logs to a specific operation.

include_statsbooleanOptional

When true, include aggregate statistics in the response. Defaults to false.

summary_onlybooleanOptional

When true, return aggregated failure patterns instead of individual log entries. Defaults to false.

top_nintegerOptional

Number of top failure patterns to return when summary_only is true (1-50). Defaults to 10.

Header parameters

X-API-Versionstring · enumOptional

Meta Business Agent API version

Possible values:

Responses

200

Log entries or failure patterns, with optional statistics

application/json

Log entries or failure patterns, with optional statistics

400

Bad request

application/json

401

Unauthorized

application/json

404

Not found

application/json

429

Too many requests

application/json

500

Server error

application/json

get/agent_connectors/{connector_id}/logs

HTTPcURLJavaScriptPython

GET /agent_connectors/{connector_id}/logs HTTP/1.1
Host: waba-v2.360dialog.io
D360-API-KEY: YOUR_API_KEY
Accept: */*

{
  "data": [
    {
      "error_message": "text",
      "event_time": "text",
      "failure_code_name": "text",
      "last_seen": "text",
      "occurrences": 1,
      "tool_name": "text"
    }
  ],
  "stats": {
    "avg_latency_s": 1,
    "exception_count": 1,
    "p95_latency_s": 1,
    "p99_latency_s": 1,
    "start_count": 1,
    "success_count": 1,
    "success_rate": 1,
    "time_window_seconds": 1
  }
}