# AskVerdict

> AskVerdict is an AI decision intelligence platform that helps teams make better decisions through structured argumentation.

## Docs

### Getting Started

- [Introduction](https://www.askverdict.ai/api/docs/getting-started/introduction/llm.txt): Learn what AskVerdict is, how multi-agent AI debates work, and why structured reasoning leads to better decisions.
- [Quick Start](https://www.askverdict.ai/api/docs/getting-started/quickstart/llm.txt): Get your first AI-powered verdict in under 5 minutes. Sign up, grab an API key, and make your first request.
- [Core Concepts](https://www.askverdict.ai/api/docs/getting-started/concepts/llm.txt): Understand debate modes, agent personas, scoring, convergence, and how AskVerdict's multi-agent system works under the hood.
- [Authentication](https://www.askverdict.ai/api/docs/getting-started/authentication/llm.txt): Learn how to authenticate with the AskVerdict API using API keys, and how to pass BYOK provider keys.

### API Reference

- [Verdict API](https://www.askverdict.ai/api/docs/api-reference/verdict-api/llm.txt): Complete guide to the AskVerdict Verdict API — from your first request to production integration with streaming, webhooks, and outcome tracking.
- [API Overview](https://www.askverdict.ai/api/docs/api-reference/overview/llm.txt): Base URL, authentication, error format, rate limits, and pagination for the AskVerdict REST API.
- [Create Verdict](https://www.askverdict.ai/api/docs/api-reference/create-verdict/llm.txt): POST /v1/verdicts — Create a new debate and get an AI-powered verdict on any question.
- [List Verdicts](https://www.askverdict.ai/api/docs/api-reference/list-verdicts/llm.txt): GET /v1/verdicts — List your debates with pagination, sorting, and filtering.
- [Get Verdict](https://www.askverdict.ai/api/docs/api-reference/get-verdict/llm.txt): GET /v1/verdicts/:id — Retrieve a specific debate with its full verdict and arguments.
- [Stream Verdict](https://www.askverdict.ai/api/docs/api-reference/stream-verdict/llm.txt): GET /v1/verdicts/:id/stream — Stream debate events in real-time via Server-Sent Events (SSE).
- [Delete Verdict](https://www.askverdict.ai/api/docs/api-reference/delete-verdict/llm.txt): DELETE /v1/verdicts/:id — Delete a debate and its associated data.
- [Errors](https://www.askverdict.ai/api/docs/api-reference/errors/llm.txt): Complete list of API error codes, rate limit handling, and retry strategies for the AskVerdict API.
- [Debates API](https://www.askverdict.ai/api/docs/api-reference/debates/llm.txt): Create, manage, and control AI debates — full CRUD plus lifecycle commands.
- [Voting & Polls API](https://www.askverdict.ai/api/docs/api-reference/voting-and-polls/llm.txt): Vote on debate arguments and create audience polls to gauge community opinion alongside AI verdicts.
- [Collections API](https://www.askverdict.ai/api/docs/api-reference/collections/llm.txt): Organize debates into named collections. Share curated sets publicly or keep them private.
- [Search & Discovery API](https://www.askverdict.ai/api/docs/api-reference/search/llm.txt): Full-text and semantic search across your debates and verdicts, with advanced filters and query suggestions.
- [Notifications API](https://www.askverdict.ai/api/docs/api-reference/notifications/llm.txt): Real-time notification stream, unread counts, and preference management for debate activity.
- [Billing & Credits](https://www.askverdict.ai/api/docs/api-reference/billing/llm.txt): Manage subscriptions, purchase credits, and track billing — checkout, balance, invoices, and portal.
- [Outcomes & Scores](https://www.askverdict.ai/api/docs/api-reference/outcomes/llm.txt): Track decision outcomes, measure accuracy scores, view calibration data, and manage decision chains.
- [Workspaces](https://www.askverdict.ai/api/docs/api-reference/workspaces/llm.txt): Create team workspaces, manage members, assign roles, and run collaborative debates.
- [User Webhooks](https://www.askverdict.ai/api/docs/api-reference/user-webhooks/llm.txt): Create and manage webhooks to receive real-time notifications when debates complete, verdicts are delivered, and more.
- [Scheduled Debates API](https://www.askverdict.ai/api/docs/api-reference/scheduled-debates/llm.txt): Automate recurring debates on a daily, weekly, or monthly cadence.
- [API Keys](https://www.askverdict.ai/api/docs/api-reference/api-keys/llm.txt): Generate, configure, and revoke API keys for programmatic access to AskVerdict.
- [API User Profile](https://www.askverdict.ai/api/docs/api-reference/me/llm.txt): Get the authenticated API user's profile via GET /v1/me.
- [API Key Usage](https://www.askverdict.ai/api/docs/api-reference/usage/llm.txt): Get monthly request usage stats for the authenticated API key via GET /v1/usage.
- [Health Checks](https://www.askverdict.ai/api/docs/api-reference/health/llm.txt): Health and readiness endpoints for AskVerdict API: /v1/health and /health.
- [Attachments & URL Context](https://www.askverdict.ai/api/docs/api-reference/attachments/llm.txt): Upload files, attach URLs, list/download attachments, and remove attachment context for debates.
- [Sharing & Public Debate Access](https://www.askverdict.ai/api/docs/api-reference/sharing/llm.txt): Create share links, update visibility settings, revoke links, and retrieve public debates by token.

### SDK

- [SDK Installation](https://www.askverdict.ai/api/docs/sdk/installation/llm.txt): Install and configure the AskVerdict TypeScript SDK for Node.js, Bun, and browser environments.
- [Client Methods](https://www.askverdict.ai/api/docs/sdk/client/llm.txt): Complete reference for AskVerdictClient methods: create, list, get, delete, stream verdicts and more.
- [Streaming](https://www.askverdict.ai/api/docs/sdk/streaming/llm.txt): Real-time event streaming with the AskVerdict SDK. Handle debate events, arguments, and verdicts as they happen.
- [TypeScript Types](https://www.askverdict.ai/api/docs/sdk/typescript/llm.txt): TypeScript type definitions for the AskVerdict SDK: Verdict, Debate, DebateEvent, and configuration types.
- [Method Reference](https://www.askverdict.ai/api/docs/sdk/methods/llm.txt): Complete reference for all AskVerdict SDK client methods — signatures, parameters, return types, and examples.
- [Error Handling](https://www.askverdict.ai/api/docs/sdk/error-handling/llm.txt): Handle SDK errors gracefully — error classes, status codes, retry patterns, and best practices for production use.
- [Integration Examples](https://www.askverdict.ai/api/docs/sdk/examples/llm.txt): Copy-pasteable SDK integration examples for Next.js, Express, Vercel Edge Functions, and Bun — including streaming and BYOK key forwarding.
- [Voting, Polls & Outcomes](https://www.askverdict.ai/api/docs/sdk/voting-polls-outcomes/llm.txt): Cast argument votes, create polls, submit real-world outcomes, and retrieve decision intelligence scores with the AskVerdict SDK.

### CLI

- [CLI Installation](https://www.askverdict.ai/api/docs/cli/installation/llm.txt): Install and configure the AskVerdict CLI tool for running debates from your terminal.
- [Commands Reference](https://www.askverdict.ai/api/docs/cli/commands/llm.txt): Complete reference for all AskVerdict CLI commands: debate, list, view, stream, delete, and more.
- [Scripting & CI/CD](https://www.askverdict.ai/api/docs/cli/scripting/llm.txt): Use the AskVerdict CLI in scripts, CI/CD pipelines, and automated workflows with JSON output.
- [Command Reference](https://www.askverdict.ai/api/docs/cli/reference/llm.txt): Detailed reference for all AskVerdict CLI commands — flags, options, examples, and exit codes.
- [CLI Workflow Recipes](https://www.askverdict.ai/api/docs/cli/recipes/llm.txt): Copy-paste shell scripts and recipes for common AskVerdict CLI workflows: batch creation, CSV export, CI/CD gates, cron summaries, and team workflows.
- [CLI Configuration](https://www.askverdict.ai/api/docs/cli/configuration/llm.txt): Configure the AskVerdict CLI: config file location, all options, environment variables, multiple profiles, and BYOK key setup.

### Guides

- [BYOK Setup](https://www.askverdict.ai/api/docs/guides/byok-setup/llm.txt): Configure Bring Your Own Key (BYOK) with OpenAI, Anthropic, or Google API keys for additional debate capacity on AskVerdict.
- [Webhooks](https://www.askverdict.ai/api/docs/guides/webhooks/llm.txt): Set up webhooks to get notified when debates complete. Includes signature verification examples in Node.js and Python.
- [Integrations](https://www.askverdict.ai/api/docs/guides/integrations/llm.txt): Connect AskVerdict with Slack, Discord, Notion, Zapier, and Make for seamless decision workflows.
- [Use Cases](https://www.askverdict.ai/api/docs/guides/use-cases/llm.txt): Real-world examples of using AskVerdict for hiring decisions, investment analysis, product decisions, and more.
- [Best Practices](https://www.askverdict.ai/api/docs/guides/best-practices/llm.txt): Tips for writing effective questions, choosing debate modes, and getting the most out of AskVerdict.
- [Slack Integration Setup Guide](https://www.askverdict.ai/api/docs/guides/slack-integration/llm.txt): Connect AskVerdict to Slack to run AI debates and receive verdicts directly in any channel using slash commands.
- [Discord Bot Integration Guide](https://www.askverdict.ai/api/docs/guides/discord-integration/llm.txt): Add the AskVerdict bot to your Discord server to run AI-powered debates using slash commands in any channel.
- [Notion Integration Guide](https://www.askverdict.ai/api/docs/guides/notion-integration/llm.txt): Export AskVerdict debates and verdicts to Notion pages for team documentation and searchable decision archives.
- [Zapier & Make.com Integration Guide](https://www.askverdict.ai/api/docs/guides/zapier-integration/llm.txt): Automate AskVerdict debates with Zapier or Make.com. Connect to 5,000+ apps using triggers and actions via REST Hooks.
- [Decision Intelligence](https://www.askverdict.ai/api/docs/guides/decision-intelligence/llm.txt): Understand how AskVerdict tracks outcomes, calculates decision scores, and helps you make better decisions over time.
- [Team Workspaces](https://www.askverdict.ai/api/docs/guides/team-workspaces/llm.txt): Create shared workspaces, invite team members, assign roles, and run debates collaboratively with AskVerdict BYOK Pro.
- [SSE Streaming Events](https://www.askverdict.ai/api/docs/guides/sse-events/llm.txt): Complete reference for all Server-Sent Events emitted during an AskVerdict debate stream, with payload schemas and consumption examples.
- [Scheduled Debates](https://www.askverdict.ai/api/docs/guides/scheduled-debates/llm.txt): Automatically run debates on a recurring schedule — daily, weekly, or monthly — using AskVerdict's scheduled debate system.
- [Migration & Breaking Changes](https://www.askverdict.ai/api/docs/guides/migration/llm.txt): AskVerdict API versioning policy, deprecation process, upgrade checklists, and templates for future breaking changes.
- [Debate Modes](https://www.askverdict.ai/api/docs/guides/mode-icons/llm.txt): Every debate mode in AskVerdict AI, what it does, and when to use it.

### Changelog

- [Changelog](https://www.askverdict.ai/api/docs/changelog/index/llm.txt): Latest updates, new features, and improvements to the AskVerdict platform, API, SDK, and CLI.

## Optional

- [Full LLM Index](https://www.askverdict.ai/api/docs/llm.txt): Complete docs listing with all endpoints
- [API Reference](https://www.askverdict.ai/api/docs/api-reference/overview/llm.txt): REST API documentation
- [Blog](https://www.askverdict.ai/blog): Technical articles and implementation guidance
- [Case Studies](https://www.askverdict.ai/case-studies): Real-world rollout stories
- [Updates](https://www.askverdict.ai/updates): Release notes and announcements
- [RSS Feed](https://www.askverdict.ai/feed.xml): Machine-readable updates feed