---
title: "Search events for a trigger"
method: POST
path: "/api/triggers/{trigger_id}/events/search"
tags: ["Triggers"]
---

# Search events for a trigger

`POST /api/triggers/{trigger_id}/events/search`

Search recent content events an existing trigger matches. Read-only — no webhook delivery is made. Covers the last seven days.

## Path parameters

- `trigger_id` string, required

## Request body

- PlatformTriggerEventSearchRequest
  - `page_size` integer — Maximum number of events to return.

## Response `200`

Successful response.

- PlatformTriggerEventSearchResponse
  - `results` PlatformTriggerEvent[], required — Matching events, most recent first.
    - `event_type` 'DOCUMENT_CHANGE', required — The kind of event.
    - `datasource` string, required — Datasource the event originated from.
    - `reason` 'CREATED' | 'UPDATED' | 'DELETED' | 'MEETS_CONDITION' | 'ASSIGNED' | 'UNASSIGNED' | 'LABELED' | 'UNLABELED' | 'REVIEW_REQUESTED' | 'REVIEW_REQUEST_REMOVED' | 'READY_FOR_REVIEW' | 'CONVERTED_TO_DRAFT' | 'WEBHOOK_UPDATED', required — Why the event fired.
    - `doc_type` string, required — Datasource-specific object type.
    - `doc_id` string, required — Identifier of the document the event is about.
    - `view_url` string, required — Link to the document in its source system.
    - `title` string, required — Title of the document, or the subject for email.
    - `event_time` string, date-time, required — When the event happened at the source: the document's own change timestamp for a document change, and the scheduled time for a content schedule. Omitted when the source did not supply one.
  - `has_more` boolean, required — Whether more events matched than were returned. Raise `page_size` to see more; cursor-based paging is not offered yet.
  - `request_id` string, required — Unique identifier for this request, for support and debugging.

## Other responses

- `400` — Invalid request (malformed JSON, invalid parameter values, unknown fields).
- `401` — Missing or invalid authentication token.
- `403` — Token valid but lacks permission for the requested operation.
- `404` — Resource not found.
- `408` — Backend did not respond within the timeout window.
- `413` — Request body exceeds the maximum allowed size.
- `429` — Rate limit exceeded. Includes Retry-After header.
- `500` — Unexpected server-side failure.
- `503` — Backend temporarily unavailable.

## Changes

> 68 revisions in range; 2 could not be searched.

- **2026-08-19** `1ea0138e1a13` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/gleanwork/apis/glean-platform-api/changes/api/triggers/:trigger_id/events/search/post.md)

---

[API](https://skmtc.dev/gleanwork/apis/glean-platform-api.md) · [All operations](https://skmtc.dev/gleanwork/apis/glean-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gleanwork/glean-platform-api/revisions/46c121f70527/schema)