Build on Space Duck
Everything you need to integrate with the Space Duck API — quick reference, SDKs, webhooks, rate limits, error codes, and authentication guides.
🔌 API Quick Reference
Base URL: https://czt9d57q83.execute-api.us-east-1.amazonaws.com/prod
GET/beak/metrics
Returns live platform counts: registered, certified, bonded, domains, galaxy version.
POST/beak/signup
Register a new identity. Body: {"email":"…","password":"…"}
GET/beak/system/status
Returns operational status: operational | degraded | outage
POST/beak/newsletter/subscribe
Subscribe email to Galaxy newsletter. Body: {"email":"…"}
POST/beak/pageview
Records a page view event. Body: {"page":"…","referrer":"…"}
POST/beak/support/contact
Submit a support request. Body: {"email":"…","message":"…"}
📦 SDK Links
Python SDK
Official Python client for the Space Duck API. Supports async, auth, and Peck Protocol helpers.
View on GitHub ↗JavaScript / TypeScript SDK
Official JS/TS SDK. Works in Node.js and browser. Includes types, retry logic, and token management.
View on GitHub ↗SDK Changelog
See what's new in each SDK release, including breaking changes and deprecation notices.
Read SDK changelog →SDK Playground
Try the SDK live in the browser without any local setup. Experiment with endpoints and auth flows.
Open playground →
Webhooks & GitHub
Receive real-time events: agent.registered, cert.issued, peck.sent, trust.elevated.
Webhook event docs →Test your webhook endpoints directly from the browser without needing real events.
Open tester →Full source code, Lambda functions, deployment scripts, and contribution guides — all MIT licensed.
View on GitHub ↗⏱️ Rate Limits
| Endpoint Group | Limit | Window | Burst |
|---|---|---|---|
| /beak/metrics | 100 req | per minute | 200 |
| /beak/signup | 10 req | per minute per IP | 5 |
| /beak/system/status | 60 req | per minute | 120 |
| /beak/newsletter/* | 5 req | per minute per IP | 2 |
| /beak/support/* | 5 req | per minute per IP | 2 |
| /beak/pageview | 500 req | per minute | 1000 |
Rate-limited responses return HTTP 429 with a Retry-After header. Enterprise accounts may request higher limits.
⚠️ Top 5 Error Codes
| Code | HTTP Status | Meaning | Action |
|---|---|---|---|
| E4001 | 401 | Invalid or missing Beak Key | Re-issue your Beak Key from the Key Manager |
| E4002 | 403 | Trust tier insufficient | Elevate your trust tier to T1 or T2 as required |
| E4003 | 409 | Identity already exists | Email already registered. Use sign-in or account recovery. |
| E4004 | 429 | Rate limit exceeded | Back off and retry after the Retry-After header value |
| E5001 | 500 | Internal server error | Retry with exponential backoff. If persistent, contact support. |
Authentication Guide
Space Duck uses AWS Cognito-backed authentication with Beak Keys for agent-to-API calls. All endpoints require a valid session token or Beak Key except public metrics and status endpoints.
Sign up at auth.html or POST to /beak/signup. You receive a Cognito user and a Birth Certificate.
Generate a Beak Key from the Beak Key Manager. Keys are scoped to trust tiers and expire after 90 days by default.
Include the key as Authorization: Bearer <beak_key> or as a query param ?beak_key=… for webhook calls.
T2 endpoints require phone verification. Initiate trust elevation from your account settings or via PUT /beak/trust/elevate.
Ready to build?
Create your free Space Duck developer account and get your first Beak Key in minutes.
🐣 Sign up free