Developer surface

Architecture API Directory

A browsable directory of the saved.archi machine layer: search suggestions, map feeds, work intelligence phases, research generation, and internal operations. It is designed as the human-readable front door for the routes already living under /api.

11 endpoints

OpenAPI 3.1.0

7 GET · 4 POST

Public JSON with one internal ingest hook

Open openapi.json Search the corpus Open Source Atlas Open research

Total endpoints

All documented handlers under /api, including one internal ingest hook.

Public endpoints

Reachable without internal authorization, though POST handlers still expect valid payloads.

Internal endpoints

Operational hooks intended for trusted automation only.

Write workflows

POST handlers for research creation, refresh, source review, and ingest.

Work intelligence

Site, source, and material intelligence around a specific work slug.

Map + search

Corpus discovery APIs for autocomplete, works maps, precedent browse, and jobs.

Distribution

Method mix

GET

Read-oriented machine endpoints.

POST

Mutation and workflow endpoints.

Distribution

Category mix

Work Intelligence

Work-level intelligence surfaces for site, source, material, and review workflows.

Discovery

Public endpoints for search, map browse, precedent-style exploration, and jobs discovery.

Operations

Service health and internal operational hooks that keep the architecture dataset moving.

Research

Write endpoints that turn architecture questions into saved, refreshable research briefs.

Quick start

Real endpoints you can hit immediately

These starter routes work directly in the browser or from the terminal and give a fast feel for the API surface.

GETPublic

/api/health

Health

Service heartbeat for saved.archi, including database configuration, reachability, and schema readiness.

Dynamic health check. Returns 200 when database config, reachability, and schema checks all pass.

Health payload with database status and timestamp.

curl https://saved.archi/api/health

Open live response

GETPublic

/api/search/suggest

Search Suggest

Lightweight corpus suggestions spanning works, architects, bureaus, cities, regions, countries, and books.

Query params

Dynamic search results sized for autocomplete UIs.

Autocomplete suggestions mixed across saved.archi entity types.

curl "https://saved.archi/api/search/suggest?q=ando"

Open live response

GETPublic

/api/map/works

Map Works

Returns mappable work results for browse mode or precedent-search mode, including facets and missing-coordinate counts.

Query params

qmodecountrycityregiontypologymaterialclimatebureaupublicAccesssortyearFromyearTo

Dynamic corpus query. No explicit edge cache headers.

Browse or precedent response with filters, facets, detected signals, and map-ready results.

curl "https://saved.archi/api/map/works?country=Japan&typology=museum"

Open live response

GETPublic

/api/map/jobs

Map Jobs

Filters architecture jobs into a map-ready response keyed by bureau, location, discipline, and hiring constraints.

Query params

qbureaucitycountryregiondisciplineemploymentTypeexperienceLevelmaterialpostedWindowrequiresPortfoliosalaryKnownsoftwaresortsourceKindtypologyvisaSupportworkplaceMode

Dynamic jobs map query sourced from Neon.

Map-ready jobs response filtered by bureau, location, and hiring metadata.

curl "https://saved.archi/api/map/jobs?city=Tokyo&discipline=architecture"

Open live response

Discovery

Public endpoints for search, map browse, precedent-style exploration, and jobs discovery.

3 endpoints

GETPublic

/api/search/suggest

Search Suggest

Lightweight corpus suggestions spanning works, architects, bureaus, cities, regions, countries, and books.

Query params

Dynamic search results sized for autocomplete UIs.

Autocomplete suggestions mixed across saved.archi entity types.

curl "https://saved.archi/api/search/suggest?q=ando"

Open live response

GETPublic

/api/map/works

Map Works

Returns mappable work results for browse mode or precedent-search mode, including facets and missing-coordinate counts.

Query params

qmodecountrycityregiontypologymaterialclimatebureaupublicAccesssortyearFromyearTo

Dynamic corpus query. No explicit edge cache headers.

Browse or precedent response with filters, facets, detected signals, and map-ready results.

curl "https://saved.archi/api/map/works?country=Japan&typology=museum"

Open live response

GETPublic

/api/map/jobs

Map Jobs

Filters architecture jobs into a map-ready response keyed by bureau, location, discipline, and hiring constraints.

Query params

qbureaucitycountryregiondisciplineemploymentTypeexperienceLevelmaterialpostedWindowrequiresPortfoliosalaryKnownsoftwaresortsourceKindtypologyvisaSupportworkplaceMode

Dynamic jobs map query sourced from Neon.

Map-ready jobs response filtered by bureau, location, and hiring metadata.

curl "https://saved.archi/api/map/jobs?city=Tokyo&discipline=architecture"

Open live response

Work Intelligence

Work-level intelligence surfaces for site, source, material, and review workflows.

4 endpoints

GETPublic

/api/work/{slug}/site-intelligence

Site Intelligence

Phase-one site intelligence for a work slug, centered on coordinates and location-derived context.

Path params

slug

Public cache: s-maxage=21600 with stale-while-revalidate=86400.

Site intelligence payload for the requested work slug.

curl "https://saved.archi/api/work/<work-slug>/site-intelligence"

GETPublic

/api/work/{slug}/phase-two

Phase Two

Phase-two work intelligence, including source graph context and deeper precedent-facing enrichment.

Path params

slug

Public cache: s-maxage=21600 with stale-while-revalidate=86400.

Phase-two work intelligence for the requested work slug.

curl "https://saved.archi/api/work/<work-slug>/phase-two"

GETPublic

/api/work/{slug}/phase-three

Phase Three

Phase-three material and carbon intelligence for a work, including palette-level enrichment when available.

Path params

slug

Public cache: s-maxage=21600 with stale-while-revalidate=86400.

Phase-three work intelligence for the requested work slug.

curl "https://saved.archi/api/work/<work-slug>/phase-three"

POSTPublic

/api/work/{slug}/source-review

Source Review

Approves or rejects candidate project-source links on a work record, then returns refreshed phase-two context.

Path params

slug

Body fields

actionproviderurltitlesubtitleyearnote

No-store response after mutating work source data.

Refreshed phase-two work intelligence after the review mutation.

curl -X POST https://saved.archi/api/work/<work-slug>/source-review -H "Content-Type: application/json" -d '{"action":"approve","provider":"ArchDaily","url":"https://www.archdaily.com/...","title":"Project title"}'

Research

Write endpoints that turn architecture questions into saved, refreshable research briefs.

2 endpoints

POSTPublic

/api/research/briefs

Create Research Brief

Creates a research brief record from a natural-language architecture question.

Body fields

question

Node runtime write endpoint. Revalidates /research and the created document path.

Created research brief payload.

curl -X POST https://saved.archi/api/research/briefs -H "Content-Type: application/json" -d '{"question":"How does adaptive reuse reshape museum design?"}'

POSTPublic

/api/research/briefs/{id}/refresh

Refresh Research Brief

Refreshes an existing research brief by document id and returns the updated record.

Path params

Node runtime write endpoint. Revalidates /research and the refreshed document path.

Refreshed research brief payload.

curl -X POST https://saved.archi/api/research/briefs/<brief-id>/refresh

Operations

Service health and internal operational hooks that keep the architecture dataset moving.

2 endpoints

GETPublic

/api/health

Health

Service heartbeat for saved.archi, including database configuration, reachability, and schema readiness.

Dynamic health check. Returns 200 when database config, reachability, and schema checks all pass.

Health payload with database status and timestamp.

curl https://saved.archi/api/health

Open live response

POSTInternal

/api/internal/jobs/process

Process Jobs Ingest

Runs the jobs-ingest pipeline, optionally scoped to a single source configuration id.

Body fields

sourceConfigId

Dynamic internal ingestion hook. Requires a bearer token in production.

Jobs ingest result payload.

curl -X POST https://saved.archi/api/internal/jobs/process -H "Authorization: Bearer <token>" -H "Content-Type: application/json" -d '{"sourceConfigId":"greenhouse-default"}'