Build with AcornOps - AcornOps

This section is for developers extending an existing AcornOps deployment.

Integration guide

Build external sessions, webhook consumers, bots, and MCP-backed capabilities.

API overview

Understand authentication, endpoint families, and integration boundaries.

Choose an integration surface

Need	Surface
Read or manage workspace resources	Public control-plane API
Follow a run	Server-sent run or execution events
Start linked user-attributable work	External integration sessions
Receive AcornOps events	Outbound webhooks
Add reviewed external tools	Remote MCP server
Perform deployment-wide support actions	Separately enabled admin API

Use the public API under /api/v1 for workspace-facing integrations. The admin API under /admin/v1 has separate enablement, authentication, scopes, and auditing. Internal component endpoints are not integration surfaces.

Start safely

Identify the user or service identity behind the action.
Request only the workspace grants and scopes the integration needs.
Preserve AcornOps session, run, and approval attribution.
Verify webhook signatures and handle at-least-once delivery.
Treat run events and error reasons as bounded operational data, not a source of secrets.