​

Webhooks API

​

Available Events

• document.uploaded - Document upload started
• document.processed - Document indexing complete
• document.deleted - Document removed
• document.processing_failed - Processing error
• dataset.created - New dataset created
• dataset.updated - Dataset metadata changed
• dataset.deleted - Dataset removed

​

Create Webhook

POST /v1/webhooks

​

Request

{
  "url": "https://your-app.com/webhooks/fltr",
  "events": ["document.processed", "document.processing_failed"],
  "description": "Production webhook",
  "active": true
}

​

Response

{
  "webhook_id": "wh_abc123",
  "url": "https://your-app.com/webhooks/fltr",
  "events": ["document.processed", "document.processing_failed"],
  "secret": "whsec_xyz789...",
  "created_at": "2024-01-10T12:00:00Z",
  "active": true
}

​

List Webhooks

GET /v1/webhooks

​

Update Webhook

PATCH /v1/webhooks/{webhook_id}

​

Delete Webhook

DELETE /v1/webhooks/{webhook_id}

​

Security

​

Retry Logic

• Attempts: 3 retries on failure
• Backoff: Exponential (1min, 5min, 30min)
• Timeout: 5 seconds per attempt

​

Limits

• Max 100 webhooks per account
• Max 1,000 deliveries per hour per webhook
• Auto-disable if >80% failure rate

​

Next Steps