spacetimedb-http
Use when calling SpacetimeDB HTTP endpoints for identity, database operations, reducer calls, SQL execution, schema metadata, logs, energy endpoints, or authorization headers. Triggers on: HTTP API, REST, Authorization header, bearer token, /v1/identity, /v1/database, HTTP reducer call, HTTP SQL.
How do I install this agent skill?
npx skills add https://github.com/danmossa/spacetimedb-skills --skill spacetimedb-httpIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides comprehensive documentation and reference material for interacting with SpacetimeDB via its HTTP API. It describes standard authorization patterns, identity management, and database operations. No malicious patterns, obfuscation, or unauthorized data access mechanisms were detected.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
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/identityreturns{ "identity": string, "token": string }.POST /v1/database/:name_or_identity/call/:reducerinvokes a reducer or procedure. The request body is a JSON array of arguments.POST /v1/database/:name_or_identity/sqlruns one or more SQL statements separated by;and returns JSON statement results withschemaandrows.GET /v1/database/:name_or_identity/schema?version=...returnsRawModuleDefJSON and maps tospacetime describe.GET /v1/database/:name_or_identity/logsrequires database ownership and maps tospacetime logs.- WebSocket subscriptions use
/v1/database/:name_or_identity/subscribewith thev1.bsatn.spacetimedborv1.json.spacetimedbsubprotocol; 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 before writing non-trivial query strings.
Reference map
| Need | Open |
|---|---|
| Authorization headers and ping | references/http-authorization.md |
| Database endpoints | references/http-database.md |
| Identity endpoints | references/http-identity.md |
Guidance
- Include the required bearer token behavior when giving endpoint examples.
- Route SQL syntax questions to spacetimedb-sql.
- Route SDK connection questions to spacetimedb-clients.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/danmossa/spacetimedb-skills/spacetimedb-http">View spacetimedb-http on skillZs</a>