API reference

Base URL

bashhttps://api.quackstack.fyi/v3

Authentication

All requests require a bearer token. Generate one at app.quackstack.fyi/settings/tokens.

bashAuthorization: Bearer qs_live_••••••••

POST /quacks

Create a new quack session.

json{
  "prompt": "why is this useEffect firing twice?",
  "context": {
    "files": [{ "path": "src/App.tsx", "content": "..." }]
  },
  "personality": "polite",
  "stream": true
}

Response (streamed Server-Sent Events when stream=true):

json{
  "id": "qk_8h2j",
  "messages": [
    { "role": "duck", "content": "Are you in React StrictMode?" }
  ],
  "usage": { "quacks": 1, "tokens": 412 }
}

GET /quacks/:id

Retrieve a quack session and all its messages.

POST /quacks/:id/messages

Send a follow-up message in an existing session.

Rate limits

Error codes

• 401 unauthorized — missing or invalid token
• 402 quota_exhausted — quack quota reached
• 429 rate_limited — back off and retry with jitter
• 500 internal_quack — the duck is napping; please retry