Webhook API

Coming soon. The Webhook API described below is on the public roadmap but not yet shipped. The endpoints (/api/workspace/<id>/trigger, /api/runs/<id>), workspace webhook tokens, and the rate-limit envelope are all targets for the next release. Today, Monroe is driven from Slack, Microsoft Teams, and email; connect Teams from Dashboard → Channels (a Microsoft admin approves Monroe if your organization requires it). See Slack install, Teams install, and the email channel. If you need API access before this ships, email enterprise@getmonroe.com and we will prioritize against your timeline.

Monroe exposes a single webhook endpoint per workspace that any external system can POST to. This lets you trigger Monroe from a cron job, an alert, your deal-management system, or any backend that produces signal worth acting on.

Endpoint

POST https://app.getmonroe.com/api/workspace/<workspace_id>/trigger
Authorization: Bearer <workspace_webhook_token>
Content-Type: application/json

{
  "task": "Summarize the OMs that landed in #deal-flow today and post the shortlist in #acquisitions",
  "channel": "#acquisitions",
  "metadata": {
    "source": "deal-flow-daily-cron",
    "trigger_id": "evt_abc123"
  }
}

Get the workspace webhook token from Dashboard → Settings → API.

Response

{
  "run_id": "run_xyz",
  "estimated_credits": 400,
  "channel": "#acquisitions",
  "status": "queued"
}

Monroe starts the run and posts the result in the specified channel. Run receipts post to metadata.run_id so external systems can correlate.

Status polling

GET https://app.getmonroe.com/api/runs/<run_id>
Authorization: Bearer <workspace_webhook_token>

Returns the current state, credits consumed so far, and the in-progress output if any.

Webhooks back (Enterprise)

For systems that need to know when Monroe finishes (e.g. a reporting workflow that waits for a Monroe-drafted IC memo), Enterprise customers can register a callback URL. Monroe POSTs {run_id, status, output_url} when the run completes.

Rate limits

• 100 requests/minute per workspace token
• 10 concurrent runs per workspace (self-serve tiers)
• 50 concurrent runs per workspace (Enterprise)

Need higher limits? Email enterprise@getmonroe.com.

Errors

Next → run log.