Prezent Webhooks

generated: '2026-07-20'
method: derived
source: openapi/prezent-openapi-original.yml (Webhooks tag + WebhookEventType + webhook-subscriptions endpoints)
spec_type: Webhooks
notes: >
  Prezent documents a first-class webhook subscription surface (no standalone AsyncAPI document
  published). Subscriptions are managed via REST; each delivery is signed and the signing secret
  is rotatable. Completion of async AutoGenerator and Template Converter jobs is delivered as events.
management:
  create: POST /api/v1/webhook-subscriptions
  list: GET /api/v1/webhook-subscriptions
  read: GET /api/v1/webhook-subscriptions/{id}
  update: PATCH /api/v1/webhook-subscriptions/{id}
  delete: DELETE /api/v1/webhook-subscriptions/{id}
  rotate_secret: POST /api/v1/webhook-subscriptions/{id}/rotate-secret
  test: POST /api/v1/webhook-subscriptions/{id}/test
subscription_status: [active, disabled]
events:
  - type: autogeneration.completed
    description: An AutoGenerator presentation build finished successfully.
  - type: autogeneration.failed
    description: An AutoGenerator presentation build failed.
  - type: template_conversion.completed
    description: A Template Converter job finished successfully.
  - type: template_conversion.failed
    description: A Template Converter job failed.
  - type: webhook.test
    description: Test event emitted by the subscription test endpoint.