Project & organization services (API)
This page is the docs hub behind geobase projects endpoints <ref>.
- Start with Global Geobase context before using service pages.
- Use this table to map each CLI endpoint row to the service page an agent should read next.
{origin} is the project API origin (for example https://<ref>.geobase.app). {services_origin} is the org services host (default https://services.geobase.app; override with GEOBASE_SERVICES_API_BASE_URL).
For JavaScript client setup patterns (browser vs server), see Geobase context.
Per-project (data-plane)
Row ids intentionally match CLI deep links from geobase projects endpoints.
| Service | Typical path | Documentation | Client notes |
|---|---|---|---|
| REST (PostgREST) | {origin}/rest/v1/ | PostgREST | Primary data reads/writes from Next.js server routes. |
| Auth (GoTrue) | {origin}/auth/v1 | Auth (GoTrue) | User sign-in and session flows for web apps. |
| Storage API | {origin}/storage/v1 | Storage API | File upload/download with bucket policies. |
| Edge Functions | {origin}/functions/v1 | Edge Functions | Custom backend actions for app workflows. |
| Analytics API | {origin}/analytics/v1/api | Analytics API | Project metrics and aggregate reporting endpoints. |
| Realtime (WebSocket) | wss://{host}/realtime/v1/websocket | Realtime (WebSocket) | Live subscriptions for reactive UI updates. |
| GraphQL | {origin}/graphql/v1 | GraphQL | Alternative query surface for read-heavy views. |
| Tileserver (vector tiles) | {origin}/tileserver/v1 | Tileserver (vector) | Vector tile map source endpoints for web maps. |
| Titiler (raster COG) | {origin}/titiler/v1 | Titiler (raster) | Raster COG tile and metadata endpoints. |
| Worker API (OpenAPI) | {origin}/worker/doc | Worker API | Background job API surface for async tasks. |
| Worker: OSM import | {origin}/worker/jobs/osmImportArea | OpenStreetMap import | Async OpenStreetMap extract for an AOI (Studio OSM Import Map). |
| Worker: Overture import | {origin}/worker/jobs/overtureImportArea | Overture import | Async Overture Maps layer import for an AOI. |
| Worker: GeoEmbeddings | {origin}/worker/jobs/createGeoEmbeddings | Worker jobs | Background embedding generation pipeline. |
| Worker: SRAI embeddings | {origin}/worker/jobs/createSraiEmbeddings | Worker jobs | Async SRAI embedding job endpoint. |
| Worker: Archive to PMTiles | {origin}/worker/jobs/archiveToPmtiles | Archive to PMTiles | Async PostGIS table archive to Storage bucket pmtiles. |
| Postgres meta (pg) | from project settings (pgMetaUrl, …) | Postgres meta | Privileged metadata APIs for internal tooling. |
Organization services (shared)
Same host for all orgs in a Geobase deployment. Use an organization Services API key (not project anon key).
| Service | Typical path | Documentation | Client notes |
|---|---|---|---|
| Routing Engine (organization services API) | {services_origin}/routing-engine/v1/route (POST) | Routing engine | Call from server-side code with org Services API key. |
Last updated on