Quickstart

curl -X POST https://api.case.dev/webhooks/v1/endpoints \
  -H "Authorization: Bearer $CASEDEV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-app.example.com/webhooks/casedev",
    "description": "Production event receiver",
    "eventTypeFilters": ["vault.ingest.completed"]
  }'

casedev webhooks:v1:endpoints create \
  --url "https://your-app.example.com/webhooks/casedev" \
  --description "Production event receiver" \
  --event-type-filter vault.ingest.completed

import Casedev from 'casedev'

const client = new Casedev({ apiKey: process.env.CASEDEV_API_KEY })

const endpoint = await client.webhooks.v1.endpoints.create({
  url: 'https://your-app.example.com/webhooks/casedev',
  description: 'Production event receiver',
  eventTypeFilters: ['vault.ingest.completed'],
})

console.log(endpoint.endpoint.id, endpoint.signingSecret)

import os
import casedev

client = casedev.Casedev(api_key=os.environ["CASEDEV_API_KEY"])

endpoint = client.webhooks.v1.endpoints.create(
    url="https://your-app.example.com/webhooks/casedev",
    description="Production event receiver",
    event_type_filters=["vault.ingest.completed"],
)

print(endpoint.endpoint.id, endpoint.signing_secret)

endpoint, _ := client.Webhooks.V1.Endpoints.New(ctx, casedev.WebhooksV1EndpointNewParams{
	URL:              casedev.F("https://your-app.example.com/webhooks/casedev"),
	Description:      casedev.F("Production event receiver"),
	EventTypeFilters: casedev.F([]string{"vault.ingest.completed"}),
})

fmt.Println(endpoint.Endpoint.ID, endpoint.SigningSecret)

import express from 'express'
import { Webhook, WebhookVerificationError } from 'casedev/webhooks'

const app = express()
const wh = new Webhook(process.env.CASEDEV_WEBHOOK_SECRET!)

app.post('/webhooks/casedev', express.raw({ type: 'application/json' }), (req, res) => {
  try {
    const event = wh.verify(req.body, req.headers)
    console.info('case.dev webhook received', { type: event.type })
    if (event.type === 'vault.ingest.completed') {
      // Trigger internal work from event.data here; do not log the payload directly.
    }
    return res.sendStatus(204)
  } catch (err) {
    if (err instanceof WebhookVerificationError) return res.status(400).send(err.code)
    throw err
  }
})

import os
from flask import Flask, abort, request
from casedev.webhooks import Webhook, WebhookVerificationError

app = Flask(__name__)
wh = Webhook(os.environ["CASEDEV_WEBHOOK_SECRET"])

@app.post("/webhooks/casedev")
def casedev_webhook():
    try:
        event = wh.verify(request.get_data(), request.headers)
    except WebhookVerificationError as exc:
        abort(400, exc.code)

    app.logger.info("case.dev webhook received", extra={"event_type": event["type"]})
    return ("", 204)

import (
	"io"
	"net/http"
	"os"

	"github.com/casemark/casedev-go/webhooks"
)

var wh, _ = webhooks.NewVerifier(os.Getenv("CASEDEV_WEBHOOK_SECRET"))

func receive(w http.ResponseWriter, r *http.Request) {
	body, _ := io.ReadAll(r.Body)
	var event webhooks.Envelope
	if err := wh.VerifyInto(body, r.Header, &event); err != nil {
		if ve, ok := webhooks.AsVerificationError(err); ok {
			http.Error(w, string(ve.Code), http.StatusBadRequest)
			return
		}
		http.Error(w, err.Error(), http.StatusInternalServerError)
		return
	}
	// event.Type is the discriminator; json.Unmarshal event.Data into the
	// event-specific struct.
	w.WriteHeader(http.StatusNoContent)
}

curl -X POST "https://api.case.dev/webhooks/v1/endpoints/$ENDPOINT_ID/test" \
  -H "Authorization: Bearer $CASEDEV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "eventType": "vault.ingest.completed",
    "payload": {
      "vaultId": "vault_123",
      "objectId": "obj_123",
      "durationMs": 1284,
      "chunkCount": 42
    }
  }'

casedev webhooks:v1:endpoints test "$ENDPOINT_ID" \
  --event-type vault.ingest.completed \
  --payload '{"vaultId":"vault_123","objectId":"obj_123","durationMs":1284,"chunkCount":42}'

await client.webhooks.v1.endpoints.test(endpointId, {
  eventType: 'vault.ingest.completed',
  payload: {
    vaultId: 'vault_123',
    objectId: 'obj_123',
    durationMs: 1284,
    chunkCount: 42,
  },
})

client.webhooks.v1.endpoints.test(
    endpoint_id,
    event_type="vault.ingest.completed",
    payload={
        "vaultId": "vault_123",
        "objectId": "obj_123",
        "durationMs": 1284,
        "chunkCount": 42,
    },
)

_, _ = client.Webhooks.V1.Endpoints.Test(ctx, endpointID, casedev.WebhooksV1EndpointTestParams{
	EventType: casedev.F("vault.ingest.completed"),
	Payload: casedev.F(map[string]any{
		"vaultId":    "vault_123",
		"objectId":   "obj_123",
		"durationMs": 1284,
		"chunkCount": 42,
	}),
})