spacetimedb-http

Use this skill for SpacetimeDB HTTP route behavior and request construction.

Core HTTP patterns

• Most HTTP endpoints accept Authorization: Bearer <token>. Without it, database endpoints usually allocate or use an anonymous identity with public-table access only.
• POST /v1/identity returns { "identity": string, "token": string }.
• POST /v1/database/:nameoridentity/call/:reducer invokes a reducer or procedure. The request body is a JSON array of arguments.
• POST /v1/database/:nameoridentity/sql runs one or more SQL statements separated by ; and returns JSON statement results with schema and rows.
• GET /v1/database/:nameoridentity/schema?version=... returns RawModuleDef JSON and maps to spacetime describe.
• GET /v1/database/:nameoridentity/logs requires database ownership and maps to spacetime logs.
• WebSocket subscriptions use /v1/database/:nameoridentity/subscribe with the v1.bsatn.spacetimedb or v1.json.spacetimedb subprotocol; prefer SDKs unless building custom tooling.

Request cautions

• Management endpoints are primarily for tooling, debugging, and administration; use SDK WebSocket clients for normal app traffic.
• Anonymous HTTP reducer calls pass an anonymous identity to ReducerContext; module auth logic may reject them.
• HTTP SQL sees only public rows for anonymous callers and is subject to RLS.
• Route SQL syntax to [spacetimedb-sql](../spacetimedb-sql/SKILL.md) before writing non-trivial query strings.

Reference map

Guidance

• Include the required bearer token behavior when giving endpoint examples.
• Route SQL syntax questions to [spacetimedb-sql](../spacetimedb-sql/SKILL.md).
• Route SDK connection questions to [spacetimedb-clients](../spacetimedb-clients/SKILL.md).