Skip to main content
The Seamind API is a REST API built on FastAPI. All endpoints return JSON responses.

​
Base URL

​
Authentication

Most endpoints require a Bearer token. Include it in the Authorization header:
Tokens are issued through SSO authentication via WorkOS.

​
API structure

The API is organized into product-scoped namespaces: Each namespace is gated by the matching product entitlement: an organization without the Crew product gets a 403 from /api/v1/crew/*.

​
Shared endpoints

​
Learn endpoints

​
Crew endpoints

As new products launch (Watch, Guard, Assist), they will each get their own namespaced API under /api/v1/{product}/. See the full schema, request/response models, and a live playground in the reference pages.

​
Conventions

  • Pagination — List endpoints accept page and page_size query parameters.
  • Search — Most list endpoints accept a search query parameter for filtering by name or title.
  • IDs — All resource IDs are UUIDs.
  • Dates — ISO 8601 format (2025-06-15T00:00:00Z).
  • Errors — Standard HTTP status codes with JSON error bodies.
The API playground on each endpoint page lets you try requests directly. You’ll need a valid Bearer token to authenticate.