API Reference

Stagent exposes a local REST API with 157 endpoints across 24 domains. All endpoints accept and return JSON. Authentication is handled by provider API keys configured in Settings.

Base URL

http://localhost:3000

Stagent runs locally. All API calls are made to your local instance.

GET Read POST Create / Execute PATCH Update DELETE Remove SSE Stream

Core

Intelligence

Content

Platform

Operations

Common Patterns

  • Validation — Request bodies validated with Zod. Errors return 400 with error.flatten() format.
  • IDs — All resources use UUID v4 identifiers, auto-generated on creation.
  • Fire-and-forget — Execution endpoints return 202 Accepted while work runs asynchronously.
  • SSE — Streaming endpoints use text/event-stream with keepalive heartbeats.
  • Timestamps — All dates are ISO 8601 strings in responses.