Create Verdict

POST /v1/verdicts — Create a new debate and get an AI-powered verdict on any question.

1 min read
Share
POST/v1/verdicts

Create a new debate and start the AI debate process.

Request Body

NameTypeRequiredDescription
questionstringRequiredThe question or decision to debate. Max 2000 characters.
modestringOptionalDebate mode: 'fast' (1 credit), 'balanced' (3 credits), or 'thorough' (8 credits). Default: 'balanced'.
contextstringOptionalAdditional context for the debate. Max 5000 characters.
optionsstring[]OptionalSpecific options to compare (e.g., ['React', 'Vue', 'Svelte']).
tagsstring[]OptionalTags for organizing debates.

Example Request

bash
curl -X POST https://api.askverdict.ai/v1/verdicts \
  -H "Authorization: Bearer vrd_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "question": "Should we migrate from PostgreSQL to MongoDB?",
    "mode": "balanced",
    "context": "We have a 5-year-old Rails app with complex joins and reporting needs. Team of 8 engineers.",
    "tags": ["infrastructure", "database"]
  }'

Response

The debate starts asynchronously. Use the Stream endpoint to watch it unfold in real-time, or poll Get Verdict until status is "completed".

Error Responses

CodeErrorDescription
400VALIDATION_ERRORMissing or invalid question
401UNAUTHORIZEDInvalid API key
402INSUFFICIENT_CREDITSNot enough credits for the selected mode
429RATE_LIMITEDToo many requests

Was this page helpful?

PreviousAPI OverviewNextList Verdicts