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
| Environment | Base URL |
|---|---|
| Production | https://app.stewi.com |
| Preview | https://preview.stewi.com |
| Local Dev | http://localhost:3000 |
All API paths referenced in this documentation are relative to the base URL of the environment you are targeting.
Integration Steps
- Provision credentials — create a steward org from the dashboard, then generate an API key and Merge webhook secret under Settings → Integrations.
- Wire Merge.dev — point Merge’s webhook to Stewi’s
/api/webhooks/mergeendpoint and verify the shared secret. - Send pipeline events — if you have custom sources, POST normalized events to
/api/pipeline/events. - Query results — poll
/api/pipeline/recordsor 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.