Sail Research Webhooks

generated: '2026-07-21'
method: searched
source: https://docs.sailresearch.com/webhooks.md
spec_type: Webhooks
summary: >-
  Sail delivers completion notifications for asynchronous inference. There is no
  published AsyncAPI document and no broad event catalog — a single completion
  event type per request.
registration:
  mechanism: per-request metadata
  fields:
    completion_window: "latency-cost tier (asap/priority/standard/flex)"
    completion_webhook: "https or http URL to POST the result to on completion"
    webhook_token: "secret sent as 'Authorization: Bearer <token>' on delivery for verification"
events:
  - name: completion
    trigger: "A request to POST /responses, POST /chat/completions, or POST /messages finishes processing."
    delivery:
      method: POST
      content_type: application/json
      body: "The same JSON object returned by GET /responses/{response_id}."
      dedup_key: "response id (webhooks may be delivered more than once)"
    retries: "up to 3 attempts on non-2xx / network error"
    timeout: "30 seconds per attempt"
    guarantee: "best-effort; failures do not affect the API response — data remains retrievable via GET."
verification:
  type: bearer-token
  header: "Authorization: Bearer <webhook_token>"
  notes: "Token-based (not cryptographic HMAC signature). Receiver validates the bearer token it set."