{"openapi":"3.1.0","info":{"title":"Corbanu Decisions API","version":"1.3.0","description":"Five grounded choices, evidence-backed voting and a readable decision report. Standard mode uses three research reports and nine votes. Budget mode uses one report, three DeepSeek Flash votes and a final Kimi rewrite. Premium mode uses three research reports, three GPT-6 Sol and three Claude Opus 5.5 votes, and an Opus final rewrite."},"servers":[{"url":"https://api.corbanu.com"}],"paths":{"/v1/decisions/models":{"get":{"operationId":"decisionModels","security":[{"corbanuApiKey":[]}],"responses":{"200":{"description":"Configured voting models, default panel, fixed critique and rewrite models"}}}},"/v1/decisions":{"post":{"operationId":"createDecision","security":[{"corbanuApiKey":[]}],"description":"Starts asynchronous work. Reuse a request ID for an identical request to avoid duplicate work. Standard mode uses three distinct panel models with three votes each. Budget mode uses DeepSeek V4.1 Flash throughout, including research generation, and Kimi K3 only for the final rewrite. Premium mode uses GPT-6 Sol for framing, planning, drafting and one review, and Claude Opus 5.5 for three votes, one review and the final rewrite, with zero data retention on those model calls.","parameters":[{"name":"X-Corbanu-Request-Id","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":100},"description":"Letters, numbers, dash, underscore, dot and colon. Generated and returned when absent."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DecisionRequest"}},"text/plain":{"schema":{"type":"string","minLength":1,"maxLength":60000}},"text/markdown":{"schema":{"type":"string","minLength":1,"maxLength":60000}}}},"responses":{"202":{"description":"Decision job","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DecisionJob"}}}},"400":{"description":"Invalid input or model panel"},"401":{"description":"Invalid API key"},"402":{"description":"A funded API balance is required"},"409":{"description":"Request ID already used with different input"},"413":{"description":"JSON body exceeds 128 KiB or raw body exceeds 64 KiB"},"429":{"description":"Three active jobs already exist for this account"},"503":{"description":"Decisions or a required model is not configured"}}}},"/v1/decisions/{id}":{"get":{"operationId":"getDecision","security":[{"corbanuApiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Decision job","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DecisionJob"}}}},"404":{"description":"No job owned by this account"}}}},"/v1/decisions/{id}/packet":{"get":{"operationId":"getDecisionPacket","security":[{"corbanuApiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"description":"Full input, prompts, research, one-pagers, votes, draft, critiques, final report and usage. Available for partial and failed jobs too.","responses":{"200":{"description":"Owner-only evidence packet","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"No job owned by this account"}}}},"/v1/decisions/{id}/report":{"get":{"operationId":"getDecisionReport","security":[{"corbanuApiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"format","in":"query","required":false,"description":"Overrides the format selected at creation","schema":{"type":"string","enum":["markdown","pdf"]}}],"responses":{"200":{"description":"Report download. Six sections in plain English: user decision, context, options, recommendation and votes, reasoning, and option vote tally. PDF is at most five pages.","content":{"text/markdown":{"schema":{"type":"string"}},"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Unsupported format"},"404":{"description":"No job owned by this account"},"409":{"description":"Job has not completed"}}}}},"components":{"securitySchemes":{"corbanuApiKey":{"type":"http","scheme":"bearer","bearerFormat":"Corbanu API key"}},"schemas":{"DecisionRequest":{"type":"object","additionalProperties":false,"required":["input"],"properties":{"input":{"type":"string","minLength":1,"maxLength":60000,"description":"Markdown or plain text describing the decision context"},"mode":{"type":"string","enum":["standard","budget","premium"],"default":"standard"},"models":{"type":"array","minItems":1,"maxItems":3,"uniqueItems":true,"items":{"type":"string","enum":["corbanu/astra-pro","corbanu/glm-5.3-flash","corbanu/glm-5.3","corbanu/gpt-5.6-luna","corbanu/gpt-5.6-sol","corbanu/kimi-k3","corbanu/deepseek-v4.1-flash"]},"default":["corbanu/astra-pro","corbanu/glm-5.3","corbanu/kimi-k3"],"description":"Standard mode: three distinct models. Budget mode: omit, or supply only corbanu/deepseek-v4.1-flash. Premium mode: omit, or supply exactly corbanu/gpt-6-sol and corbanu/claude-opus-5.5."},"format":{"type":"string","enum":["markdown","pdf"],"default":"markdown"}},"allOf":[{"if":{"properties":{"mode":{"const":"budget"}},"required":["mode"]},"then":{"properties":{"models":{"minItems":1,"maxItems":1,"items":{"const":"corbanu/deepseek-v4.1-flash"},"default":["corbanu/deepseek-v4.1-flash"]}}},"else":{"if":{"properties":{"mode":{"const":"premium"}},"required":["mode"]},"then":{"properties":{"models":{"const":["corbanu/gpt-6-sol","corbanu/claude-opus-5.5"],"default":["corbanu/gpt-6-sol","corbanu/claude-opus-5.5"]}}},"else":{"properties":{"models":{"minItems":3,"maxItems":3}}}}}]},"DecisionJob":{"type":"object","required":["id","status","stage","models","runs_per_model","completed_calls","total_calls","report_url","packet_url"],"properties":{"id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["queued","running","completed","failed"]},"stage":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"models":{"type":"array","items":{"type":"string"}},"runs_per_model":{"type":"integer","const":3},"mode":{"type":"string","enum":["standard","budget","premium"]},"completed_calls":{"type":"integer","minimum":0,"maximum":18},"total_calls":{"type":"integer","enum":[10,15,18]},"selected":{"type":"string","enum":["A","B","C","D","E"]},"vote_counts":{"type":"object","additionalProperties":{"type":"integer","minimum":0,"maximum":9}},"error":{"type":"string"},"billing":{"type":"object"},"research_progress":{"type":"array","items":{"type":"object"}},"report_url":{"type":"string"},"packet_url":{"type":"string"},"corbanu":{"type":"object"}}}}}}