INFRASTRUCTURE

Webhooks & Events

Build asynchronous content pipelines. Kompyl pushes job updates and artifact URLs directly to your application.

POST /webhooks/kompyl200 OK

{
  "event": "job.completed",
  "job_id": "job_998877",
  "timestamp": "2024-03-20T10:00:00Z",
  "payload": {
    "status": "succeeded",
    "artifacts": {
      "pptx": "https://api.kompyl.com/v1/download/deck.pptx",
      "guide": "https://api.kompyl.com/v1/download/guide.pdf",
      "brain": "https://api.kompyl.com/v1/download/brain.json"
    },
    "metrics": {
      "slides_generated": 14,
      "compliance_score": 100
    }
  },
  "signature": "sha256=..."
}

Retry Logic

Exponential backoff for failed deliveries ensures you never miss a completion event.

Security

All payloads are signed with your API secret using HMAC-SHA256.

Artifact Retention

Links remain valid for 24 hours, or configure streaming directly to your S3 bucket.