Etchv Webhooks

generated: '2026-10-20'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://etchv.com/docs/api/webhooks
sources:
- https://etchv.com/docs/api/webhooks
description: Etchv sends signed webhook events when a watermarking job or batch finishes, or when a GPU accelerator becomes ready.
events:
- event: watermark.embed.succeeded
  description: Verified output is ready.
- event: watermark.embed.failed
  description: Processing failed; credits held for the job are released.
- event: watermark.detect.succeeded
  description: Detection finished; fetch the result to see whether a watermark was found.
- event: watermark.detect.failed
  description: Detection failed; credits held for the job are released.
- event: watermark.batch.completed
  description: A batch ended with at least one file watermarked.
- event: watermark.batch.failed
  description: A batch ended with no file watermarked; credits for failed files are refunded.
- event: watermark.batch.cancelled
  description: A canceled batch ended; files that did not run are not charged.
- event: accelerator.ready
  description: A requested GPU wake‑up is ready.
delivery:
  auth: Each delivery is signed with an HMAC‑SHA256 hex digest using the endpoint’s signing_secret (including the leading “whsec_”). The signature
    is sent in the X‑Etchv‑Signature header and must be verified against the X‑Etchv‑Timestamp and raw request body.
  signature: v1= plus an HMAC‑SHA256 hex digest
  retries: Up to 10 attempts over about 22 hours; each retry uses the same event ID and JSON body but a new timestamp and signature. Duplicate
    events and out‑of‑order deliveries are expected.
note: Endpoints must be public HTTPS URLs on port 443; Etchv blocks private, loopback, link‑local and reserved addresses and does not follow redirects.
docs: https://etchv.com/docs/api/webhooks