Webhooks & Events — CaveauAI by Blue Note Logic

Event Types

document.ingested production

Fired when a document has been fully processed — chunked, embedded, and indexed. Includes document ID, chunk count, and corpus ID.

document.failed production

Fired when document processing fails. Includes error type, document ID, and suggested remediation.

corpus.updated production

Fired when a corpus is modified — new documents, deletions, or reindexing. Includes change summary and new document count.

model.ready enterprise

Fired when a fine-tuned model completes training and is ready for deployment. Includes benchmark scores and model metadata.

query.completed enterprise

Fired after each query completes. Includes query text, response time, source count, and confidence score. Useful for analytics dashboards.

Webhook Registration

curl -X POST https://ai.bluenotelogic.com/api/v2/webhooks \
  -H "Authorization: Bearer $BLUENOTE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-app.com/webhooks/bluenote",
    "events": ["document.ingested", "corpus.updated"],
    "secret": "whsec_your_signing_secret"
  }'

Payload Format

{
  "id": "evt_abc123",
  "type": "document.ingested",
  "created_at": "2026-03-24T10:30:00Z",
  "data": {
    "document_id": "doc_xyz789",
    "corpus_id": "corp_abc123",
    "filename": "contract-2026.pdf",
    "chunks": 47,
    "status": "ready"
  }
}

Retry Policy

We retry failed deliveries with exponential backoff: 30s, 2m, 15m, 1h, 4h. After 5 failures, the webhook is paused and you're notified via email. You can reactivate paused webhooks from your dashboard.