---
title: API Documentation — 3Dogs Nexus
description: Public API documentation for 3Dogs Nexus adversarial multi-model decision intelligence: signup, login, case submission, and case listing endpoints.
url: https://3dogs.ai/docs/api/
---

API Documentation — 3Dogs Nexus

- 

← 3dogs.ai · OpenAPI spec (JSON) · Auth guide (markdown) · API catalog

# 3Dogs Nexus API

Submit a high-stakes business decision; a panel of 8–32 AI models across three clouds researches, debates, and returns a decisive recommendation with preserved dissent. Base URL: https://app.3dogs.ai

Auth model for these documented operations: session cookie. Separate OAuth/OIDC discovery metadata is published for the declared Cognito identity service, but its presence does not prove that these application operations accept bearer tokens; follow each operation's OpenAPI security declaration. Every new account gets a 30-day free trial automatically. Agents may create accounts only on behalf of a real user, with that user's consent.

## Endpoints

GET/healthPublic health check. Returns {"status":"ok","service":"3dogs-nexus"}.

POST/api/signupCreate an account. Body: {"email":"...","password":"..."}. 409 if the account exists. After signup, the user accepts Terms at /onboard before the first case.

POST/api/loginStart a session. Body: {"email":"...","password":"..."}. Sets the session cookie.

GET/api/whoamiReturns the logged-in identity for the current session.

POST/intakeSubmit a decision case (authenticated). Minimal body:

{
 "email": "you@example.com",
 "q1": "The decision, in full — situation, options, constraints, numbers, deadlines. Any language.",
 "mode": ""
}
mode: "" = 3Dogs decides (may ask clarifying questions) · "direct" = no follow-ups, ~5 min · "deep" = 3-panel ensemble, most rigorous. Optional guided fields q2–q26 add structure but q1 alone is sufficient. Returns a case_id; watch the live debate at /watch?case=<id>. The report is delivered as a PDF by email and in the dashboard.

GET/api/my-casesList the account's cases: status, pending clarification questions, PDF links, and plan/trial info (authenticated).

## Answering clarification questions

Cases in default and deep modes may pause with clarifying questions. They appear in /api/my-cases and in the dashboard, where the user answers in a reply box. Answers can be written in any language.

## Machine-readable discovery

/.well-known/api-catalog (RFC 9727 linkset) · /.well-known/openapi.json · /.well-known/agent-skills/index.json · /llms.txt

## Enterprise

Document-scale Deep Discovery (10,000+ page data rooms, half-million-email investigations), custom connectors, and dedicated or in-your-perimeter deployments are sales-led: alan@3dogs.ai · (702) 845-2886

3Dogs Nexus · Terms · Privacy · Security