Skip to main content
The public v1 API gives you team-scoped access to Synthbrew resources.

​
Base URL

{SYNTHBREW_API_HOST}/api/public/v1
Local default: 
http://localhost:3311/api/public/v1

​
Authentication

Public v1 endpoints require a team API key in the x-api-key header. 
x-api-key: sb_api_...
You can issue these keys from Settings > Team > Public API keys.

​
Scope model

  • Keys are team-scoped.
  • A key only accesses resources from its team.
  • If projectsScope is set when issuing the key, the key can only access those project IDs.

​
Endpoint groups

  • /projects for project CRUD.
  • /projects/{projectId}/schemas for schema CRUD.
  • /projects/{projectId}/sources for source CRUD.
  • /projects/{projectId}/sources/{sourceId}/regenerate to trigger source regeneration.
  • Generation observability:
    • /projects/{projectId}/sources/{sourceId}/generation-jobs/{jobId}
    • /projects/{projectId}/sources/{sourceId}/generation-events

​
Quick start

curl --request GET \
  --url http://localhost:3311/api/public/v1/projects \
  --header "x-api-key: sb_api_your_key_here"