Help Topic

API And SDK Support

Generate API keys, use the SDK and CLI, and understand operational limits for integration work.

How do I get an API key?

Go to Settings → API in the sidebar. Click Generate API Key, give it a name (e.g. "production", "CI"), and copy the key immediately. It is only shown once.

API keys inherit your account's credit balance. Each key can be revoked individually from the same settings page.

How do I use the TypeScript SDK?

Install the SDK:

npm install @askverdict/sdk

Basic usage:

const client = new AskVerdict({ apiKey: process.env.ASKVERDICT_API_KEY });

const debate = await client.debates.create({ question: 'Should we migrate to microservices?', mode: 'balanced', });

// Stream the verdict for await (const event of client.debates.stream(debate.id)) { console.log(event); } ```

Full SDK documentation is available at askverdict.ai/docs/sdk.

What are the API rate limits?

Rate limits depend on your plan:

  • Free: 10 signup credits (via API or web), 10 req/min on other endpoints
  • Credit pack users: 5 concurrent debates, 60 req/min
  • BYOK subscribers: 20 concurrent debates, 120 req/min

Rate limit headers (X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset) are included in every API response. If you need higher limits, contact hello@askverdict.ai.

How do I use AskVerdict from the command line?

Install the CLI globally:

npm install -g @askverdict/cli

Authenticate:

askverdict auth login

Run a debate:

askverdict debate "Should I switch to Bun for our Node.js services?" --mode balanced

The CLI streams the verdict to your terminal with rich formatting. Run askverdict --help for all available commands.

Related help topics

Browse adjacent support areas for faster troubleshooting and onboarding.

For production-impacting issues, check the status page first, then include relevant request IDs when contacting support.