Skip to main content
Use the Erstan Developer API to run published Agents, manage authoring drafts, and inspect durable run evidence from external systems. Choose direct REST calls, the JavaScript SDK, or hosted MCP according to your application. For interactive Claude and Codex clients, the official Erstan plugin adds OAuth-authenticated MCP tools and maintained Skills for building agents and working with authorized workspace content.

JavaScript SDK (private beta)

Node.js client with TypeScript declarations, run helpers, and guarded authoring. Available as a reviewed beta tarball; public npm publication is pending.

Direct REST quickstart

Use HTTP directly from any language, without installing the SDK.
The first supported workflow is:
  1. Create a scoped API key in Erstan.
  2. List the agents that key can access.
  3. Start an agent run.
  4. Poll the run until it completes.

​
Base URL

​
Authentication

Public API requests use a workspace API key as a bearer token.
API keys are created in the Erstan app by a workspace owner or admin. The secret is shown once when the key is created.

​
Endpoints

See Quickstart for a copy-paste flow. The API Reference also includes workspace context, Agent/Skill authoring and history, guarded previews, explicit publication, and durable run traces. Authoring requires the matching workspace capabilities and scopes; publishing the docs does not enable it. See the SDK reference for the JavaScript methods and optional samples for private-repository usage without a required development workflow.

​
Build agents over MCP

Install the official Erstan plugin and authorize the Build profile for the recommended browser-based OAuth flow. Advanced automation clients can connect directly to POST /v1/mcp with an API key holding agents:read plus agents:write. In either case, Erstan rechecks the connection owner’s live access on every call. See Connect a Coding Agent for installation and Build agents over MCP for the complete authoring workflow. For a complete NetSuite scheduled-script example with email body plus optional file attachment, see NetSuite OCR Quote Intake.