Skip to main content
GET
/
v1
/
memory
/
insights
List memory insights
curl --request GET \
  --url https://api.example.com/v1/memory/insights \
  --header 'Authorization: <authorization>'

​
Overview

Returns a list of AI-generated insights about your system’s health, recurring failure patterns, and improvement opportunities. Insights are computed periodically from resolved incidents, knowledge patterns, and remediation outcomes. Required role: admin or member

​
Request headers

​
Authorization
string
required
JWT Bearer token. Format: Bearer <your-jwt>.

​
Query parameters

​
category
string
Filter by insight category. One of: reliability, performance, security, cost, toil.
​
severity
string
Filter by insight severity. One of: critical, high, medium, low, info.
​
limit
integer
Maximum number of insights to return. Default: 20. Maximum: 100.
​
cursor
string
Pagination cursor from a previous response.

​
Response

Returns 200 OK. 
{
  "items": [
    {
      "insightId": "ins_01HX9VTPQR3KF8MZWBYD5N6JCE",
      "category": "reliability",
      "severity": "high",
      "title": "Connection pool exhaustion — recurring pattern",
      "summary": "Your checkout service has hit connection pool limits 3 times in the last 90 days, always within 10 minutes of a new deployment. Consider setting a higher default or adding a pre-deploy canary check.",
      "affectedServices": ["checkout-service", "payment-processor"],
      "incidentCount": 3,
      "generatedAt": "2024-04-01T06:00:00Z"
    }
  ],
  "total": 7,
  "nextCursor": null
}
FieldTypeDescription
insightIdstringUnique insight identifier
categorystringInsight domain: reliability, performance, security, cost, toil
severitystringImportance: critical, high, medium, low, info
titlestringShort insight summary
summarystringFull insight with recommended action
affectedServicesstring[]Services involved in this pattern
incidentCountintegerNumber of incidents that contributed to this insight
generatedAtstringISO 8601 timestamp when the insight was generated

​
Error responses

StatusError codeDescription
401unauthorizedMissing or invalid JWT
403forbiddenCaller lacks required role

​
Examples

curl "https://api.causeflow.ai/v1/memory/insights?category=reliability&severity=high" \
  -H "Authorization: Bearer eyJhbGc..."

Chat with memory

Ask questions about your incident history

Knowledge patterns

View extracted failure patterns