Platform API

The Worlds architecture separates management operations from graph data operations:

Authentication

Platform API requests use platform tokens with the wzp_ prefix:

Authorization: Bearer wzp_...

Platform tokens manage resources. World auth tokens use the wzw_ prefix and are intended for data-plane access to specific worlds.

Base URL

https://api.wazoo.dev/v1/

For local development of the Platform API server, use the Wrangler dev URL for your Worker.

Resources

The Platform API covers these management resources:

Resource	Routes
Worlds	`/v1/worlds`, `/v1/worlds/:worldId`
Platform tokens	`/v1/auth/api-tokens`
World auth tokens	`/v1/worlds/:worldId/auth/tokens`
Usage	`/v1/worlds/:worldId/usage`
Limits	`/v1/worlds/:worldId/limits`
Billing	`/v1/worlds/:worldId/billing`, `/v1/worlds/:worldId/billing/openPortal`
Users	`/v1/users/me`
Stripe webhook	`/v1/stripe/webhook`

worlds-api mints each immutable world ID as w_<ULID>. The Platform API stores it as world_id, and both APIs expose the unchanged value as id. Create requests define a display name but no caller-selected ID or slug field. Use world.id as the worldId path parameter.

POST /v1/worlds
Authorization: Bearer wzp_YOUR_PLATFORM_TOKEN
Content-Type: application/json

{
  "world": {
    "displayName": "My World",
    "region": "auto"
  }
}

HTTP/1.1 201 Created

{
  "world": {
    "id": "w_01jd8x5mqv7k3n9r2t4w6y8z0b",
    "displayName": "My World",
    "region": "auto",
    "state": "ACTIVE",
    "restorable": false,
    "backend": "worlds-api"
  }
}

Data-plane boundary

The Platform API does not execute SPARQL, search triples, import RDF, or export RDF. Those operations belong to the Worlds Data API (data.wazoo.dev), its generated client @worlds/client, or the embedded @worlds/sdk. The Data API runs inside a Cloudflare Worker. Graph data lives in a shared Cloudflare D1 database, partitioned by world. Each world gets a cached WorldsSdk instance backed by:

D1QuadStore — RDF triple storage with D1-backed hexastore indexes.
CloudflareSearchIndex — FTS5 keyword search projected into D1.
WazooSparqlEngine — the sparql-engine evaluator, wired to a D1RdfjsStore that streams quads from D1 on each query (no in-memory hydration).

SPARQL and search requests run against this per-world SDK instance inside the Worker isolate. See Query for details on the query path.

TypeScript SDK — typed client for the Platform API.
Worlds CLI — command-line management of worlds.
Console tokens — create and revoke platform tokens.
OpenAPI spec — live API reference.

Welcome

Platform

Skills

Ecosystem

Worlds

Guides

Console

Wazoo CLI

Integrations

Comparisons

Open source

Legal

Worlds API

Platform API

Authentication

Base URL

Resources

Data-plane boundary

​Authentication

​Base URL

​Resources

​Data-plane boundary

​Related

Authentication

Base URL

Resources

Data-plane boundary

Related