Change Intelligence
"What changed since yesterday?" is more important than "what exists?" Monitor document changes with webhooks, polling feeds, and cursor-based sync.
Change feed API
Query for document changes since any timestamp
Query for documents created, updated, or deleted since any timestamp. Returns structured change events with document metadata and change type.
GET /v1/corpora/:id/changes?since=2024-06-01T00:00:00Z
{
"changes": [
{
"document_id": "...",
"url": "https://...",
"change_type": "created | updated | deleted",
"changed_at": "2024-06-15T...",
"content_hash": "sha256:..."
}
],
"cursor": "..."
}Webhook subscriptions
Push-based change notifications
Push-based notifications
Register an HTTPS endpoint to receive signed notifications when documents change. Filter by change type, source, or attribute to reduce noise.
HMAC-SHA256 signatures
Every webhook delivery is signed so you can verify authenticity. Reject unsigned or tampered deliveries.
Retry with backoff
Failed deliveries are retried with exponential backoff. Subscriptions are automatically disabled after sustained failures.
Polling with cursors
Pull-based integration pattern
For pull-based integrations, use cursor-based polling. Start with a timestamp, receive a cursor with each response, and use it to fetch the next batch. Cursors are stable - you won't miss changes or see duplicates.
Use cases
Common change intelligence workflows
Compliance monitoring and alerting
Sync pipelines to downstream systems
Daily change digests and briefings
Entity watchlists with structured alerts
Audit trails for regulatory changes
Trigger workflows on new documents