Stewi API

Overview

How to integrate with Stewi's ingestion and stewardship API.

Overview

Stewi ingests raw collaboration data, normalizes it, and exposes the resulting decisions through a single API. Use this guide to onboard your Merge.dev sources, stream events into the processing pipeline, and query the outcomes that power your AI safeguards.

Base URLs

EnvironmentBase URL
Productionhttps://app.stewi.com
Previewhttps://preview.stewi.com
Local Devhttp://localhost:3000

All API paths referenced in this documentation are relative to the base URL of the environment you are targeting.

Integration Steps

  1. Provision credentials — create a steward org from the dashboard, then generate an API key and Merge webhook secret under Settings → Integrations.
  2. Wire Merge.dev — point Merge’s webhook to Stewi’s /api/webhooks/merge endpoint and verify the shared secret.
  3. Send pipeline events — if you have custom sources, POST normalized events to /api/pipeline/events.
  4. Query results — poll /api/pipeline/records or subscribe via Inngest to react in real time.

We recommend enabling the optional sandbox org so you can replay sample payloads without touching production data.

On this page