API Reference

Accept an incoming webhook. Responds immediately with 202 Accepted. The payload is stored and queued for delivery.

Path / query params

HTTP 202 Accepted
{ "eventId": "64f1a2b3c4d5e6f7a8b9c0d1" }

List all webhooks for the authenticated user/organization.

[{ "id": "...", "name": "Stripe prod", "targetUrl": "https://...", "isActive": true, ... }]

Create a new webhook. Returns the webhook with its ingress URL and signing secret.

Request body

{
  "id": "...",
  "name": "Stripe prod",
  "targetUrl": "https://yourapp.com/webhooks",
  "ingressToken": "tok_...",
  "signingSecret": "whsec_...",
  "isActive": false,
  "maxRetries": 3,
  "retryDelaySeconds": 60,
  "rateLimitPerMinute": 0,
  "incomingSignatureType": "stripe",
  "payloadFilters": [],
  "healthStatus": "healthy",
  "createdAt": "2024-05-01T12:00:00.000Z"
}

Get a single webhook by ID.

Path / query params

Update any webhook field. All fields are optional — only provided fields are updated.

Path / query params

Request body

Permanently delete a webhook and all its events.

Path / query params

204 No Content

Toggle the webhook's isActive status (pause/activate).

Path / query params

{ "isActive": false }

Generate a new ingress token. The old ingress URL stops working immediately.

Path / query params

{ "ingressToken": "tok_newtoken..." }

Generate a new signing secret. The old secret stops working immediately.

Path / query params

{ "signingSecret": "whsec_newsecret..." }

List events with optional filters. Returns paginated results.

Path / query params

{
  "data": [{ "id": "...", "status": "delivered", "createdAt": "...", ... }],
  "total": 142,
  "page": 1,
  "limit": 15
}

Get all distinct event types (top-level type field) seen on a webhook. Used to populate filter dropdowns.

Path / query params

["payment_intent.succeeded", "payment_intent.created", "customer.subscription.updated"]

Get a single event with its full payload.

Path / query params

List all delivery attempts for an event, including response body, latency, and target info.

Path / query params

[{
  "id": "...",
  "targetUrl": "https://yourapp.com/webhooks",
  "attempt": 1,
  "statusCode": 200,
  "responseBody": "ok",
  "latencyMs": 143,
  "success": true,
  "attemptedAt": "2024-05-01T12:00:00.000Z"
}]

Manually replay an event. Creates a new delivery attempt with the original payload.

Path / query params

{ "ok": true }

Replay all failed events for a webhook.

Path / query params

{ "queued": 12 }

Cancel a pending or retrying event. Cannot be undone, but can be replayed.

Path / query params

204 No Content

Aggregate delivery stats for the current user.

Path / query params

{ "total": 1200, "delivered": 1180, "failed": 20, "successRate": 98.3 }

Latency percentiles (ms) for successful deliveries.

Path / query params

{ "avg": 210, "p95": 580, "p99": 1240 }

List all routers.

Create a router with conditional routing rules.

Request body

Update a router.

Path / query params

Delete a router.

Path / query params

204 No Content

List all filter nodes.

Create a filter node.

Request body

Update a filter node.

Path / query params

Delete a filter node.

Path / query params

204 No Content

List all transform nodes.

Create a transform node.

Request body

Update a transform node.

Path / query params

Delete a transform node.

Path / query params

204 No Content

List all schema validators.

Create a schema validator.

Request body

Update a schema validator.

Path / query params

Delete a schema validator.

Path / query params

204 No Content

List all delay nodes.

Create a delay node.

Request body

Update a delay node.

Path / query params

Delete a delay node.

Path / query params

204 No Content

List all merge nodes.

Create a merge node.

Request body

Update a merge node.

Path / query params

Delete a merge node.

Path / query params

204 No Content

List all approval nodes.

Create an approval node.

Request body

Approve a pending event at this gate.

Path / query params

Reject a pending event at this gate.

Path / query params

Update an approval node.

Path / query params

Delete an approval node.

Path / query params

204 No Content

List all email actions.

Create an email action.

Request body

Update an email action.

Path / query params

Delete an email action.

Path / query params

204 No Content

List all Gmail nodes.

Create a Gmail node.

Request body

Update a Gmail node.

Path / query params

Delete a Gmail node.

Path / query params

List the account's Gmail labels.

Path / query params

List all HTTP actions.

Create an HTTP action.

Request body

Update an HTTP action.

Path / query params

Delete an HTTP action.

Path / query params

204 No Content

List all MongoDB actions.

Create a MongoDB action.

Request body

Update a MongoDB action.

Path / query params

Delete a MongoDB action.

Path / query params

204 No Content

List all notification actions (Slack/Discord).

Create a notification action.

Request body

Update a notification action.

Path / query params

Delete a notification action.

Path / query params

204 No Content

List all Google Sheets actions.

Create a Sheets action.

Request body

Update a Sheets action.

Path / query params

Delete a Sheets action.

Path / query params

204 No Content

List all scheduled webhooks.

Create a scheduled webhook (cron-based HTTP calls).

Request body

Update a scheduled webhook.

Path / query params

Delete a scheduled webhook.

Path / query params

204 No Content

Embedding providers and their models: id, dimensions, max input tokens, price per million tokens, and whether the model is available on the managed backend.

Storage backends: hostwebhook (managed), mongo_atlas, mongo_external, pgvector — with the config fields each one needs.

Test a bring-your-own backend before creating the store. Reports server version, vector support, and whether the index or table exists; for Mongo it returns the index JSON to create, for Postgres the SQL.

Request body

pgvector only: idempotently create the extension, table and index the test reported missing, then re-test.

Request body

List the organization's stores with their stats.

Create a store. Provider, model and backend are immutable afterwards — every chunk is vectorised under them.

Request body

One store, with its embedding config, backend, chunking and stats.

Path / query params

Update what is mutable: name, description, credentialId (same provider only), chunking (applies to future ingests), isActive (pause / resume), requireCleanScan, dedupOnIngest.

Path / query params

Drop the store and every chunk in it. Nodes and AI tools that reference it keep the id and fail until re-pointed — the dashboard shows them as disconnected.

Path / query params

204 No Content

Current chunk count, stored bytes, tokens embedded, and last usage.

Path / query params

Paginated audit log: create, update, insert_chunks, query, delete, delete_chunks — with timestamp, user and source IP.

Path / query params

Chunk, embed and store text and/or an uploaded file. Content type (JSON, CSV, Markdown, code, prose) is detected and split structure-aware; a chunk identical to one already stored is skipped when dedup is on.

Path / query params

Request body

{
  "chunksInserted": 42,
  "skipped": 3,
  "bytes": 21014,
  "sourceCount": 2,
  "upsertedOver": 18,
  "warnings": ["json: value at chapters[4] exceeded the per-chunk limit and was split as text"],
  "skippedFiles": [{ "name": "logo.png", "reason": "binary" }]
}

Semantic search: the query is embedded with the store's model (billed to the store's key) and compared against every chunk. Returns the top-K matches with scores.

Path / query params

Request body

{
  "matches": [
    {
      "chunkId": "665f...",
      "content": "Refunds are issued to the original payment method within 14 days…",
      "score": 0.871,
      "sourceDocId": "https://example.com/policies/returns",
      "sourceDocName": "Returns policy",
      "metadata": { "tenant": "acme", "lang": "en" }
    }
  ],
  "tookMs": 212
}

Delete chunks by id, by document, or by metadata filter. At least one selector is required; an empty selector deletes nothing and returns deletedCount: 0 with a skippedReason.

Path / query params

Request body

{ "deletedCount": 18 }

Delete every chunk and keep the store, its config and its credential.

Path / query params

{ "deletedCount": 1204 }

Paginated browse of chunks, without embeddings — what the Content tab shows.

Path / query params

List all canvas snapshots.

Save a canvas snapshot (nodes + edges layout).

Request body

Get a single snapshot.

Path / query params

Delete a snapshot.

Path / query params

204 No Content

Dry-run replay an event through a historical canvas snapshot.

Request body

{
  "steps": [{ "node": "schema-validator", "name": "...", "result": "pass" }, ...],
  "finalStatus": "delivered",
  "matchedNodes": 4
}

Validate recent events against connected schema validators.

Path / query params

{
  "score": 94,
  "totalChecked": 100,
  "passed": 94,
  "failed": 6,
  "validators": [{ "id": "...", "name": "...", "passRate": 94 }]
}