query_events
Filter and retrieve raw events by date, project, model, user, and status with pagination. Ideal for inspecting individual errors, user actions, or model behavior.
Instructions
Raw event query with date range, project/model/status/user filters and pagination. Use for inspecting individual events (errors, specific users, model behaviour, prompt previews). By default returns up to 100 rows; pass all: true to disable the limit (use sparingly).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| org | No | Organization (tenant) ID. Omit to use the default org from $BEACON_ORG. | |
| from | No | Start date inclusive (YYYY-MM-DD). | |
| to | No | End date inclusive (YYYY-MM-DD). | |
| project | No | Project name to filter by (exact match). Use 'all' to disable. | |
| model | No | Model name to filter by (substring match). Use 'all' to disable. | |
| user | No | User name or id to filter by (substring match). Accepts source_user_name or source_user_id. | |
| status | No | Restrict to error or success events only. | |
| limit | No | Max rows to return (1-500). Ignored when `all` is true. | |
| all | No | If true, return every matching row without a limit. Use carefully — may return large payloads. |