Skip to main content
WEBHOOK
job.completed
{
  "id": "whev_abc123",
  "type": "job.completed",
  "created_at": "2025-01-15T10:30:00Z",
  "api_version": "v1",
  "data": {
    "id": "job_abc123",
    "type": "image_generation",
    "status": "completed",
    "model": "fal-ai/flux/schnell",
    "progress": 100,
    "prompt": "A serene mountain landscape at golden hour",
    "result": {
      "images": [
        {
          "url": "https://store.crevio.co/blobs/generated.png",
          "file_id": "file_abc123",
          "content_type": "image/png",
          "width": 1024,
          "height": 1024
        }
      ],
      "seed": 42
    },
    "credits_used": 3,
    "provider_request_id": "req_abc123",
    "started_at": "2025-01-15T10:30:00Z",
    "completed_at": "2025-01-15T10:30:00Z",
    "created_at": "2025-01-15T10:30:00Z"
  }
}

Headers

​
X-Crevio-Hmac-SHA256
string
required

Base64-encoded HMAC-SHA256 of the raw request body, keyed with your endpoint's signing secret. Verify this before processing the event.

Body

application/json

Event payload Crevio POSTs to your endpoint.

​
id
string
required

Unique identifier for this webhook event

Example:

"whev_abc123"

​
type
enum<string>
required

The event type

Available options:
job.completed
Example:

"job.completed"

​
created_at
string<date-time>
required

ISO 8601 timestamp of when the event was created

Example:

"2025-01-15T10:30:00Z"

​
api_version
string
required

API version used to generate the payload

Example:

"v1"

​
data
object
required

The serialized job for this event

Response

200

Return any 2xx status within 5 seconds to acknowledge receipt.