Worker jobs

Use this page with Global Geobase context.

What this service is

Worker jobs are task-specific endpoints under the project worker API.

When an agent should use it in a Next.js app

Use for asynchronous actions that should not block request-response cycles.

Base URL from CLI output

{origin}/worker/jobs/osmImportArea
{origin}/worker/jobs/overtureImportArea
{origin}/worker/jobs/createGeoEmbeddings
{origin}/worker/jobs/createSraiEmbeddings
{origin}/worker/jobs/archiveToPmtiles

Auth required

Use server-side credentials only; do not call these directly from browser code.

Job quick reference

Job	Purpose	Guide
`osmImportArea`	OpenStreetMap extract → project tables	OpenStreetMap import
`overtureImportArea`	Overture Maps layers → `{prefix}_{suffix}` tables	Overture import
`createGeoEmbeddings`	GeoAI / GeoTIFF embeddings	GeoEmbeddings
`createSraiEmbeddings`	SRAI OSM + H3 embeddings	Automated SRAI pipeline
`archiveToPmtiles`	PostGIS table → Storage `pmtiles/{table}.pmtiles`	Archive to PMTiles

Cancel pending/running jobs with DELETE {origin}/worker/jobs/{taskName}/{job_id} (Studio: DELETE /api/projects/{ref}/jobs/{taskName}/{job_id}).

Minimal request example


curl -X POST "${GEOBASE_PROJECT_URL}/worker/jobs/createGeoEmbeddings" \
  -H "apikey: ${GEOBASE_SERVICE_ROLE_KEY}" \
  -H "Authorization: Bearer ${GEOBASE_SERVICE_ROLE_KEY}" \
  -H "Content-Type: application/json" \
  -d '{}'

For map imports, see OpenStreetMap and Overture (require areaName, aoiGeoJson, plus topics or types).

For table archives, see Archive to PMTiles (requires { "table": "…" } and a Storage bucket named pmtiles).

Human checkpoint

Verify payload schema and expected job status lifecycle before wiring UI polling.