errors
Read grouped $error events for a project (GET /errors). Errors is a Pro read. A free account gets 403 PRO_REQUIRED, the same status and error code as POST /query, and that rejection is not metered. Each successful call counts as one metered read. Errors is the post-ship guardrail next to compare: after a ship, read errors for the same window before you keep the change. The group key is a SHA-256 fingerprint of the normalized message (URL query strings and hashes removed, then UUIDs, hex hashes, and numbers replaced), the source filename without query or hash, and the numeric line. There is no stack, and col is not part of the key. Each group includes fingerprint, a sample message, source, line, count, users, sessions, first_seen, last_seen, and up to 3 top_paths. count, users, sessions, and top_paths use the since/until window. first_seen and last_seen use every stored $error for that fingerprint. Groups with no event in the window are omitted. since defaults to 7 days and accepts 7d or YYYY-MM-DD. until defaults to today UTC. limit defaults to 20 and maxes at 100. new_since is a YYYY-MM-DD or an annotation title. A date is used directly. Any other string matches project annotations by exact title, then case-insensitive title, then note, then substring. Zero matches is 400. More than one match is 400 with matches listing occurred_at and title. The group new_since boolean is present only when this param is set, and is true when first_seen is on or after the resolved date. new_since_annotation is returned only when new_since matched an annotation. Every response includes approximate, a boolean. When approximate is true, caps is an array of the scan caps that were hit: distinct_triples and window_rows. There is no singular cap field. A large project stays 200. The response also includes truncated.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"project": "<project>"
},
"name": "errors"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max groups. Defaults to 20 and maxes at 100 | |
| since | No | Lookback window: 7d or YYYY-MM-DD. Defaults to 7 days | |
| until | No | Inclusive end date YYYY-MM-DD. Defaults to today UTC | |
| project | Yes | Project name or ID | |
| new_since | No | YYYY-MM-DD or an annotation title. Zero matches is 400. More than one match is 400 with matches of occurred_at and title |