From de886d3084803e92054898f7f56571dd7fb9b77d Mon Sep 17 00:00:00 2001 From: Ryan Brodkin <236564+brodkin@users.noreply.github.com> Date: Wed, 22 Jul 2026 20:53:12 -0700 Subject: [PATCH] Correct events.list schema for the type filter and count limit The events.list schema documented the `type` filter as accepting create|move|delete|edit|lock|unlock|restore. The events API rejects all of these with HTTP 400. Those are per-event `action` values; the `type` parameter accepts event categories only: file_system, note, or permission_change. Because agents are instructed to trust the schema over external docs, this caused a filtered query to fail or return nothing. Also document the count maximum (100), which the API enforces and the search operations already state, and update the example to use a valid type value. --- src/lib/schema-registry.js | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/src/lib/schema-registry.js b/src/lib/schema-registry.js index 4be921a..6236476 100644 --- a/src/lib/schema-registry.js +++ b/src/lib/schema-registry.js @@ -490,12 +490,12 @@ const SCHEMA = { mutating: false, query_params: { id: { type: 'integer', required: true, description: 'Start event ID — get from events get-cursor' }, - count: { type: 'integer', required: false, description: 'Number of events to return (default 20)' }, + count: { type: 'integer', required: false, description: 'Number of events to return (default 20, max 100)' }, folder: { type: 'string', required: false, description: 'Filter events to a specific folder path' }, - type: { type: 'string', required: false, description: 'Filter by event type(s), pipe-separated: create|move|delete|edit|lock|unlock|restore' }, + type: { type: 'string', required: false, description: 'Filter by event category, pipe-separated: file_system|note|permission_change. Note: create, move, delete and similar are per-event "action" values, not categories, and are rejected here.' }, suppress: { type: 'string', required: false, description: 'Suppress own events: "app" (default) or "user"' }, }, - example: "egnyte events list --json '{\"id\":12345,\"count\":20,\"folder\":\"/Shared\",\"type\":\"create|move\"}'", + example: "egnyte events list --json '{\"id\":12345,\"count\":20,\"folder\":\"/Shared\",\"type\":\"file_system\"}'", }, // ── Notes / Comments ────────────────────────────────────────────────────────