# Collective X API

- [Ask a question — one-shot JSON answer](https://docs.collectivex.health/api-reference/ask-a-question/ask-a-question-—-one-shot-json-answer.md): One-shot, synchronous endpoint. Always returns `application/json` (the `SyncResponse` shape) — there is no streaming mode and no `stream` field. This is the recommended path for Claude Skills, MCP tool calls, agent pipelines, and any caller that wants the full answer before processing — the same con…
- [Have a conversation — streaming or sync](https://docs.collectivex.health/api-reference/have-a-conversation/have-a-conversation-—-streaming-or-sync.md): Dual-mode endpoint. By default (`stream` omitted or `true`) returns a streaming UIMessage SSE response compatible with the Vercel AI SDK `useChat` hook. Send `stream: false` to receive a synchronous JSON response (the `SyncResponse` shape) suited for Claude Skills, MCP tool calls, and agent pipeline…
- [Submit a question as an async job (asynchronous /v1/query)](https://docs.collectivex.health/api-reference/async-jobs/submit-a-question-as-an-async-job-asynchronous-v1query.md): Submit exactly the request body you would send to `POST /v1/query` and get a job id back immediately, instead of waiting for the grounded answer on an open connection. The answer is produced in the background and read with `GET /v1/jobs/{id}` — see the "Async jobs" tag description for the lifecycle,…
- [Poll an async job's status](https://docs.collectivex.health/api-reference/async-jobs/poll-an-async-jobs-status.md): Read-only poll for one async job's current state. Jobs are created by `POST /v1/jobs` — see the "Async jobs" tag for the lifecycle, retention, and polling guidance.
- [Mint a short-lived, scoped session token for a mobile client](https://docs.collectivex.health/api-reference/session-tokens/mint-a-short-lived-scoped-session-token-for-a-mobile-client.md): Exchanges your long-lived partner key for a short-lived, scoped Unkey key that a mobile client can call `/v1/query` and `/v1/chat` with directly — see "Mobile-direct access" in the introduction for the full pattern and a runnable example.
- [Overview](https://docs.collectivex.health/index.md): Grounded answers from a peer-reviewed women's-health research corpus, with inline citations on every answer.
- [Quickstart](https://docs.collectivex.health/quickstart.md): Send one question to /v1/query and get one grounded, cited answer back.
- [Authentication](https://docs.collectivex.health/authentication.md): Bearer key auth, and why your API key must never leave your server.
- [Structured answers (beta)](https://docs.collectivex.health/structured-answers.md): Ask /v1/query for a machine-readable structured_answer alongside the normal response.
- [Async jobs](https://docs.collectivex.health/async-jobs.md): Submit a /v1/query question as a background job with POST /v1/jobs and poll GET /v1/jobs/{id} for the answer.
- [Errors and rate limits](https://docs.collectivex.health/errors-and-rate-limits.md): The error envelope, every error code, and how to stay inside your rate budget.

## OpenAPI Specs

- [openapi](/openapi.yaml)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.