Skip to main content
The SeaOtter control plane is documented from the same OpenAPI schema the API serves.

Base URL

Paths in the reference are absolute from that host (for example /api/v1/agents).

Authenticate in the playground

  1. Create a control-plane key in Settings → API keys (so_…).
  2. In any endpoint page, open Try it / Authorization.
  3. Set Bearer token to your API key (not a Clerk session JWT).
See Authentication for when to use API keys vs Clerk.

Machine-readable schema

  • Production: GET https://seaotter-api-bpenevambq-uc.a.run.app/openapi.json
  • Public filtered copy: openapi.public.json

Resource groups

Create an agent and poll stages using the Quickstart and Provisioning lifecycle guides before diving into the full surface.