Primary API Surfaces

API Reference

Forge HTTP API as implemented in the Forge server. Default port SKIA_PORT = 4173. For the full route index see docs/API_REFERENCE.md in the repository.

Browser & Static

Method	Path	Notes
GET	`/`	Redirect to `/platform-downloads` (static `public/platform-downloads.html`)
GET	`/forge`	Same redirect (legacy path)
GET	`/forge/app`	Web IDE (build the SKIA Forge IDE bundle first)
GET	`/resources`, `/security`, `/contact`	Static pages
GET	`/docs/*`	Branded HTML then markdown fallback

Auth Proxy

Method	Path
POST	`/api/auth/login`
POST	`/api/auth/register`
GET	`/api/auth/session`

Proxied to SKIA_BACKEND_URL. Marketing pages omit web sign-in UI; use the SKIA Forge IDE.

App Distribution

Method	Path
GET	`/api/app/version-check`
GET	`/api/app/release-assets`
GET	`/api/app/download`
GET	`/api/app/download/:platform`

Health & Status

Method	Path	Description
GET	`/health`	Service health check
GET	`/live`	Liveness probe
GET	`/ready`	Readiness probe
GET	`/version`	Service version

Integration

Method	Path	Description
GET	`/integration/skia-full`	Adapter status and contract map
GET	`/integration/skia-full/probe`	Live contract probe summary
GET	`/integration/skia-full/probe/report`	Detailed probe report
POST	`/integration/skia-full/chat`	Chat via SKIA brain
POST	`/integration/skia-full/route`	Reasoning router
POST	`/integration/skia-full/routing-estimate`	Routing estimate

Forge Module Surfaces

Prefix	Domain
`/api/forge/context/*`	Context engine, embeddings, semantic chunking
`/api/forge/agent/*`	Agent planner and executor
`POST /api/forge/sdlc`	SDLC intelligence
`/api/forge/production/*`	Production adapter
`/api/forge/healing/*`	Healing executor
`/api/forge/architecture/*`	Architecture diagnostics
`/api/forge/orchestrate`	Full orchestration flow
`/api/forge/control-plane`	Control plane snapshot
`/api/forge/governance`	Governance mode and policy

RPC

POST /rpc — SKIA-backed operations with local fallbacks for unavailable upstream paths

Error Model

Schema validation errors return structured request feedback with field-level detail

Upstream unavailability returns explicit SKIA unavailable errors

Governance blocks return mode and policy-based decision context with remediation guidance