# QMind Math API

> REST API for imported Math research, reports, tasks, and review workflows. Documentation is public; application requests require a scoped Math API key.

Base URL: https://math-api.qmindlabs.ai. Start with the agent setup guide, then fetch only the guides and endpoint contracts needed for the user's task. Use the OpenAPI contract for exact fields and examples. IDs in examples are synthetic.

Reviewer access is assignment-scoped; scopes cannot expand roles or cross dashboards. Keep keys private. API and dashboard writes are not yet synchronized. Live AWS/Vast job control is outside this API. MCP is not deployed; use REST.

## Start here
- [Agent setup guide](https://math-api.qmindlabs.ai/docs/agents.md): Setup prompt, private configuration, verification, workflow recipes, and MCP status.
- [Setup prompt](https://math-api.qmindlabs.ai/docs/agent-setup.txt): Copyable instructions for a coding agent.
- [Endpoint catalog](https://math-api.qmindlabs.ai/docs/api-reference.md): All 46 operations, scopes, and links to individual Markdown contracts.
- [OpenAPI specification](https://math-api.qmindlabs.ai/api/openapi.json): Complete machine-readable requests, responses, schemas, and synthetic examples.

## Guides
- [Build with the Math API](https://math-api.qmindlabs.ai/docs/index.md): Your interface to Math research, reports, and review workflows. Find the right data, automate reviews, and connect your tools.
- [Quickstart](https://math-api.qmindlabs.ai/docs/quickstart.md): Authenticate, find your tasks, and inspect a report. Start with read-only requests.
- [Authentication](https://math-api.qmindlabs.ai/docs/authentication.md): Every application request is authenticated with a Math API key in the Authorization header.
- [Roles & scopes](https://math-api.qmindlabs.ai/docs/permissions.md): Give each integration the access it needs. Roles, scopes, and task assignments are checked together.
- [Review workflow](https://math-api.qmindlabs.ai/docs/guides/workflow.md): Read the current state, apply one action, and use the returned version for the next update.
- [Reports & attachments](https://math-api.qmindlabs.ai/docs/guides/files.md): Download verified research artifacts and add supplementary files to a task.
- [Filtering & pagination](https://math-api.qmindlabs.ai/docs/guides/pagination.md): Retrieve predictable pages and narrow queries to the work you need.
- [Errors & limits](https://math-api.qmindlabs.ai/docs/guides/errors.md): Interpret failures, handle conflicts, and stay within service limits.
- [Data coverage](https://math-api.qmindlabs.ai/docs/data-coverage.md): Understand which data and operations the current Math API represents.

## Optional
- [Complete guide bundle](https://math-api.qmindlabs.ai/llms-full.txt): All guide text and the compact endpoint catalog in one file. Individual schema contracts remain behind the endpoint links.