LogsList patterns

List patterns

Records grouped by pattern: bodies that differ only in ISO dates, UUIDs, hex ids and numbers of 4 or more digits. Short numbers are kept, so status codes stay apart. new_only=1 keeps patterns with no record in the lookback_days before from and adds baseline, which says how much of that lookback the 30-day retention still covers.

curl -X GET "https://mythic-analytics.gulp.workers.dev/client/v1/logs/patterns?location_id=example_string&from=2026-10-18T10%3A00%3A00Z&to=example_string&range=15m&levels=error%2Cfatal&services=checkout&q=timeout%20%22connection%20reset%22&attr=%5B%22http.status_code%3D500%22%5D&new_only=1&lookback_days=7&limit=50&offset=0" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "success": true,
  "data": {
    "from": "2024-12-25T10:00:00Z",
    "to": "2024-12-25T10:00:00Z",
    "patterns": [
      {
        "pattern_id": "v1:892ea82429dfa0bf975caecb03a9e5ea",
        "template": "order <num> placed for user 42",
        "count": 10,
        "errors": 42,
        "first_seen": "2024-12-25T10:00:00Z",
        "last_seen": "2024-12-25T10:00:00Z",
        "service": "example_string",
        "level": "example_string",
        "services": 42,
        "sample": {
          "uuid": "example_string",
          "body": "example_string"
        }
      }
    ],
    "baseline": {
      "baseline_from": "2024-12-25T10:00:00Z",
      "baseline_to": "2024-12-25T10:00:00Z",
      "retained_from": "2024-12-25T10:00:00Z",
      "complete": true,
      "covered_days": 3.14
    }
  }
}
GET
/client/v1/logs/patterns
GET
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token
Bearer Tokenstring
Required

Agency key (ak_) or location secret key (sk_). Scoped keys (mcp_) are accepted too and need logs:read. See Using an mcp_ key over HTTP.

Agency key (ak_) or location secret key (sk_). Scoped keys (mcp_) are accepted too and need logs:read. See Using an mcp_ key over HTTP.
query
location_idstring

Location to scope to. Required for ak_ keys (or send the X-Location-Id header); ignored for sk_.

query
fromstring

Window start, ISO 8601 or epoch milliseconds. Default is range (or 1 hour) before to.

query
tostring

Window end, exclusive. Default now.

query
rangestring

Preset window ending at to. Ignored when from is set. At most 30 days.

Options: 15m, 1h, 6h, 24h, 7d, 30d
query
levelsstring

Comma list of levels.

query
servicesstring

Comma list of service names, at most 20.

query
qstring

Case-insensitive body search. Whitespace-separated terms must all match; double quotes keep a phrase. At most 5 terms.

query
attrarray

Repeatable attribute filter, key=value or a bare key. Resource attributes are resource.<key>. At most 5.

query
new_onlystring
Options: 1, true
query
lookback_daysinteger

Baseline for new patterns.

Min: 1 • Max: 7
query
limitinteger
Min: 1 • Max: 200
query
offsetinteger
Min: 0 • Max: 10000
Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. Agency key (ak_) or location secret key (sk_). Scoped keys (mcp_) are accepted too and need logs:read. See Using an mcp_ key over HTTP.

Query Parameters

location_idstring

Location to scope to. Required for ak_ keys (or send the X-Location-Id header); ignored for sk_.

fromstring

Window start, ISO 8601 or epoch milliseconds. Default is range (or 1 hour) before to.

Example:
2026-10-18T10:00:00Z
tostring

Window end, exclusive. Default now.

rangestring

Preset window ending at to. Ignored when from is set. At most 30 days.

Allowed values:15m1h6h24h7d30d
levelsstring

Comma list of levels.

Example:
error,fatal
servicesstring

Comma list of service names, at most 20.

Example:
checkout
qstring

Case-insensitive body search. Whitespace-separated terms must all match; double quotes keep a phrase. At most 5 terms.

Example:
timeout "connection reset"
attrarray

Repeatable attribute filter, key=value or a bare key. Resource attributes are resource.<key>. At most 5.

Example:
["http.status_code=500"]
new_onlystring
Allowed values:1true
lookback_daysinteger

Baseline for new patterns.

Responses

successboolean
dataobject