> For the complete documentation index, see [llms.txt](https://docs.360dialog.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.360dialog.com/docs/mba/api-ref/knowledge-connectors/list-connector-error-logs.md).

# 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.

```json
{"openapi":"3.1.0","info":{"title":"Business Agent API","version":"1.51.5"},"tags":[{"name":"Knowledge - Connectors","description":"Endpoints for managing the agent's external API connectors"}],"servers":[{"description":"Production server","url":"https://waba-v2.360dialog.io"}],"security":[{"D360-API-KEY":[]}],"components":{"securitySchemes":{"D360-API-KEY":{"description":"API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.","in":"header","name":"D360-API-KEY","type":"apiKey"}},"schemas":{"knowledge_connectors.BizAIOmniChannelConnectorLogStatsResponse":{"description":"Log entries or failure patterns, with optional statistics","properties":{"data":{"description":"Array of log entries or failure patterns depending on query mode","items":{"$ref":"#/components/schemas/knowledge_connectors.BizAIOmniChannelConnectorLogEntry"},"type":"array","uniqueItems":false},"stats":{"$ref":"#/components/schemas/knowledge_connectors.BizAIOmniChannelConnectorLogStats"}},"required":["data"],"type":"object"},"knowledge_connectors.BizAIOmniChannelConnectorLogEntry":{"description":"A log entry (individual mode) or failure pattern (summary_only mode)","properties":{"error_message":{"description":"Error message from the failed operation","type":"string"},"event_time":{"description":"ISO 8601 UTC timestamp of when the error event occurred (individual log entry mode)","type":"string"},"failure_code_name":{"description":"Human-readable name of the failure code (e.g. TRANSPORT_ERROR)","type":"string"},"last_seen":{"description":"ISO 8601 UTC timestamp of the most recent occurrence (summary_only mode)","type":"string"},"occurrences":{"description":"Number of times this failure pattern occurred (summary_only mode)","type":"integer"},"tool_name":{"description":"The tool that was being used when the error occurred","type":"string"}},"type":"object"},"knowledge_connectors.BizAIOmniChannelConnectorLogStats":{"description":"Aggregate statistics for the queried time window, present when include_stats is true","properties":{"avg_latency_s":{"description":"Average execution latency in seconds","type":"number"},"exception_count":{"description":"Number of failed tool executions","type":"integer"},"p95_latency_s":{"description":"95th percentile execution latency in seconds","type":"number"},"p99_latency_s":{"description":"99th percentile execution latency in seconds","type":"number"},"start_count":{"description":"Total number of tool execution starts","type":"integer"},"success_count":{"description":"Number of successful tool executions","type":"integer"},"success_rate":{"description":"Ratio of successful executions to total starts","type":"number"},"time_window_seconds":{"description":"Number of seconds in the statistics time window. Reflects the actual covered window, which may be smaller than the requested range if the most recent logs have not yet been processed.","type":"integer"}},"required":["avg_latency_s","exception_count","p95_latency_s","p99_latency_s","start_count","success_count","success_rate","time_window_seconds"],"type":"object"},"knowledge_connectors.StandardError":{"description":"Standard error response for Meta Business Agent endpoints","properties":{"detail":{"description":"Human-readable explanation of the error","type":"string"},"status":{"description":"HTTP status code","type":"integer"},"title":{"description":"Short, human-readable summary of the problem","type":"string"},"type":{"description":"A URI reference identifying the problem type","type":"string"}},"type":"object"}}},"paths":{"/agent_connectors/{connector_id}/logs":{"get":{"description":"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.","operationId":"get-agent-connectors-logs","parameters":[{"description":"Meta Business Agent API version","in":"header","name":"X-API-Version","schema":{"enum":["2.0.0"],"type":"string"}},{"description":"The unique identifier of the connector","in":"path","name":"connector_id","required":true,"schema":{"type":"string"}},{"description":"Start of the time range (Unix seconds). Defaults to 24 hours ago. Must be within the last 7 days.","in":"query","name":"start_time","schema":{"type":"integer"}},{"description":"End of the time range (Unix seconds). Defaults to now.","in":"query","name":"end_time","schema":{"type":"integer"}},{"description":"Maximum number of log entries to return (1-1000). Defaults to 100.","in":"query","name":"limit","schema":{"type":"integer"}},{"description":"Optional tool ID to filter logs to a specific operation.","in":"query","name":"tool_id","schema":{"type":"string"}},{"description":"When true, include aggregate statistics (success rate, latency percentiles, counts) in the response. The returned time_window_seconds reflects the actual covered window, which may be smaller than the requested range. Defaults to false.","in":"query","name":"include_stats","schema":{"type":"boolean"}},{"description":"When true, return aggregated failure patterns instead of individual log entries. Defaults to false.","in":"query","name":"summary_only","schema":{"type":"boolean"}},{"description":"Number of top failure patterns to return when summary_only is true (1-50). Defaults to 10.","in":"query","name":"top_n","schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/knowledge_connectors.BizAIOmniChannelConnectorLogStatsResponse"}}},"description":"Log entries or failure patterns, with optional statistics"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/knowledge_connectors.StandardError"}}},"description":"Bad request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/knowledge_connectors.StandardError"}}},"description":"Unauthorized"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/knowledge_connectors.StandardError"}}},"description":"Not found"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/knowledge_connectors.StandardError"}}},"description":"Too many requests"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/knowledge_connectors.StandardError"}}},"description":"Server error"}},"summary":"List connector error logs","tags":["Knowledge - Connectors"]}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.360dialog.com/docs/mba/api-ref/knowledge-connectors/list-connector-error-logs.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.