Buildspace
API Reference

Configuration

Shared configuration options for server and client SDK initialization.

Options:

  • baseUrl: runtime API base URL (default https://api.buildspace.studio). In apps, set BUILDSPACE_API_URL (server) or NEXT_PUBLIC_BUILDSPACE_API_URL (browser); @buildspace/config’s getApiUrl() reads BUILDSPACE_API_URL.
  • loginUrl: hosted login base URL (default https://login.buildspace.studio)
  • version: API version header value (default 2025-06-01)
  • fetch: custom fetch implementation (server only where needed)

Client-only extra options:

  • events.flushInterval: milliseconds between automatic flushes (default 5000)
  • events.maxBatchSize: max queued events before an automatic flush (default 20)