Skip to main content
GET
/
v1
/
knowledge
List patterns
curl --request GET \
  --url https://api.example.com/v1/knowledge

​
Overview

Returns a paginated list of patterns that CauseFlow AI has learned from resolved incidents. Patterns represent recurring failure signatures — as more incidents are resolved and feedback is submitted, patterns gain confidence and transition from emerging to stable. Required role: admin or member

​
Query parameters

​
status
string
Filter by pattern maturity. One of: emerging, stable.
  • emerging — pattern has been seen fewer than 5 times or has low confidence
  • stable — pattern has been confirmed across multiple incidents with high confidence
​
minConfidence
number
Minimum confidence score (0–1 inclusive). Only patterns with a confidence value greater than or equal to this threshold are returned. Example: 0.8 returns only high-confidence patterns.
​
limit
integer
default:"20"
Number of patterns to return per page. Maximum 100.
​
cursor
string
Cursor token from a previous response to fetch the next page. Omit for the first page.

​
Response

Returns 200 OK with a paginated list of patterns. 
{
  "patterns": [
    {
      "patternId": "pat_01HX9VTPQR3KF8MZWBYD5N6JCE",
      "title": "Connection pool exhaustion under payment processor load spike",
      "confidence": 0.94,
      "occurrences": 12,
      "status": "stable",
      "createdAt": "2024-02-15T08:00:00Z",
      "lastSeenAt": "2024-04-01T14:31:00Z"
    },
    {
      "patternId": "pat_01HX9VTPQR3KF8MZWBYD5N6JCF",
      "title": "Deployment-triggered cache invalidation cascade",
      "confidence": 0.61,
      "occurrences": 3,
      "status": "emerging",
      "createdAt": "2024-03-20T11:45:00Z",
      "lastSeenAt": "2024-03-28T09:12:00Z"
    }
  ],
  "count": 34,
  "cursor": "eyJpZCI6InBhdF8..."
}
FieldTypeDescription
patternIdstringUnique identifier for the pattern
titlestringHuman-readable summary of the failure pattern
confidencenumberConfidence score between 0 and 1. Higher values indicate more reliable matches
occurrencesintegerNumber of incidents where this pattern was confirmed
statusstringPattern maturity: emerging or stable
createdAtstringISO 8601 timestamp when the pattern was first identified
lastSeenAtstringISO 8601 timestamp of the most recent incident matching this pattern
countintegerTotal number of patterns matching the query across all pages
cursorstringCursor token for the next page. null if no more pages.

​
Examples

# List stable patterns with confidence >= 0.8
curl "https://api.causeflow.ai/v1/knowledge?status=stable&minConfidence=0.8&limit=20" \
  -H "Authorization: Bearer <token>"