# HANK AI Documentation

> Guides, API references, and release notes for the HANK AI product suite — autonomous medical coding and revenue-cycle automation. Every page is available as raw markdown at its `/index.md` URL.

## Programmatic access

- [Ask AI](https://docs.hank.ai/api/ask): `POST` a JSON `{ "question": "…" }` to get an answer grounded in the public docs, returned with citations.
- [MCP server](https://docs.hank.ai/mcp): a JSON-RPC Model Context Protocol endpoint. Read tools — `list_docs` (the slug tree), `search_docs`, `get_page`, `get_section`, `list_changelog`, `list_api_specs`/`get_openapi` — let an agent discover slugs and ground itself in the live docs; with a scoped identity, `upsert_topic` publishes a topic.
- [Docs structure (JSON)](https://docs.hank.ai/api/structure): the full public product → manual → topic tree (slugs + titles) — discover real slugs before fetching a page.
- [Full corpus](https://docs.hank.ai/llms-full.txt): every public page concatenated as raw markdown — the whole corpus in one fetch for grounding.
- [Changelog feed (all products)](https://docs.hank.ai/changelog/rss.xml): a single global RSS feed of release notes across every product, newest first; the same feed as JSON at https://docs.hank.ai/api/changelog (omit `product` for the global feed, or pass `?product=<slug>` for one product).
- [Glossary](https://docs.hank.ai/glossary): plain-language definitions of the domain jargon and acronyms used across the docs; the same dictionary as JSON at https://docs.hank.ai/api/glossary (omit `product` for the global terms, or pass `?product=<slug>` to also include a product's scoped vocabulary).
- [Content API spec (OpenAPI 3.1)](https://docs.hank.ai/api/openapi.json): the self-describing, machine-readable contract for the PUBLIC content surfaces above — `/api/structure`, `/api/search`, `/api/section`, `/api/changelog`, `/api/glossary`, and `POST /api/ask` — with query params, status codes, and response shapes (for codegen and agent tooling). No auth required for any of them.
- [REST API](https://docs.hank.ai/api/v1): a bearer-token REST API (`Authorization: Bearer <token>`, `hank-docs` scope). `POST https://docs.hank.ai/api/v1/topics/upsert` is the pipeline-gated, idempotent programmatic publish path (key on a stable `sourceKey`).
- [OpenAPI 3.1 spec](https://docs.hank.ai/api/v1/openapi.json): the self-describing, machine-readable contract for the entire REST API above (for codegen) — browse it at [https://docs.hank.ai/developers/api](https://docs.hank.ai/developers/api).
- [API quickstart](https://docs.hank.ai/developers/getting-started): new integrators start here — get a token, make the first REST call, publish a topic, handle the error codes, respect rate limits, and call the MCP server.
- [Agent integration guide](https://docs.hank.ai/developers/agents): the orchestration recipe for an autonomous agent — chain these surfaces into a discover → search → retrieve → ground → cite loop, and publish idempotently back through review.
- [Resource lifecycle guide](https://docs.hank.ai/developers/guides/crud): the full resource-management lifecycle over the REST API — the products → manuals → chapters → topics hierarchy, create/list/filter, the metadata-only update seam, idempotent content publishing, and deletes.
- [API error reference](https://docs.hank.ai/developers/errors): the catalog of HTTP status codes and error codes the REST API returns — what each means and how a client should handle it.
- [Connect a publisher](https://docs.hank.ai/hank-codes/getting-started/connect-a-publisher/index.md): the getting-started guide for publishing documentation over the API or MCP.

## Trust & compliance

- [Trust & data practices](https://docs.hank.ai/trust): how this documentation platform handles analytics, feedback, free text, AI assistance, and content review — described against what the platform technically does, verifiable in the source.
- [Report a security issue](https://docs.hank.ai/trust#report): responsible-disclosure channel for this documentation site; also machine-readable at https://docs.hank.ai/.well-known/security.txt (RFC 9116).
- [Compliance](https://docs.hank.ai/compliance): an index of the compliance-review surfaces — data practices, security disclosure, the tamper-evident audit trail, and content-review governance.

## [HANK Claim Maker](https://docs.hank.ai/hank-claim-maker)

Build clean claims, fast.

- [Adding and Managing Custom User Roles](https://docs.hank.ai/hank-claim-maker/guide/custom-roles/index.md)
- [Admin View Layout](https://docs.hank.ai/hank-claim-maker/guide/admin-view-layout/index.md)
- [Attach a Document to a Case](https://docs.hank.ai/hank-claim-maker/guide/attach-document-to-a-case/index.md)
- [Claim Maker Export Options](https://docs.hank.ai/hank-claim-maker/guide/export-options/index.md)
- [Claim Maker LITE](https://docs.hank.ai/hank-claim-maker/guide/claim-maker-lite/index.md)
- [Claim Maker Overview](https://docs.hank.ai/hank-claim-maker/guide/overview/index.md): Turn clinical documentation into submission-ready claims.
- [Coding Cases in Hank Claim Maker](https://docs.hank.ai/hank-claim-maker/guide/coding-cases-in-hank-claim-maker/index.md)
- [Create New Batch (If needed)](https://docs.hank.ai/hank-claim-maker/guide/create-new-batch/index.md)
- [Data Entry](https://docs.hank.ai/hank-claim-maker/guide/data-entry/index.md)
- [Decoding Claim Maker Alert Emails](https://docs.hank.ai/hank-claim-maker/guide/decoding-claim-maker-alert-emails/index.md)
- [Schedule Reconciliation](https://docs.hank.ai/hank-claim-maker/guide/schedule-reconciliation/index.md)
- [Admin Role – Updating ASA Crosswalk](https://docs.hank.ai/hank-claim-maker/guide/admin-role-updating-asa-crosswalk/index.md)
- [Claim Maker Exports Explained](https://docs.hank.ai/hank-claim-maker/guide/claim-maker-exports-explained/index.md)
- [Claim Maker LITE Self Service Workflow](https://docs.hank.ai/hank-claim-maker/guide/claim-maker-lite-self-service/index.md)
- [Coder View Layout](https://docs.hank.ai/hank-claim-maker/guide/coder-view-layout/index.md)
- [Coding Line Items](https://docs.hank.ai/hank-claim-maker/guide/coding-line-items/index.md)
- [Create New Case](https://docs.hank.ai/hank-claim-maker/guide/create-new-case/index.md)
- [Data Entry Fields](https://docs.hank.ai/hank-claim-maker/guide/data-entry-fields/index.md)
- [Event Descriptions and Recommended User Responses](https://docs.hank.ai/hank-claim-maker/guide/user-response/index.md)
- [Getting Started with Claim Maker](https://docs.hank.ai/hank-claim-maker/guide/getting-started/index.md)
- [Manually Uploading Documents for Processing](https://docs.hank.ai/hank-claim-maker/guide/manually-uploading-documents-for-processing/index.md)
- [Reconcile View Layout](https://docs.hank.ai/hank-claim-maker/guide/reconcile-view-layout/index.md)
- [Admin Role – Managing Users and Access and More!](https://docs.hank.ai/hank-claim-maker/guide/managing-users-and-access/index.md)
- [Assigning Batches and Cases](https://docs.hank.ai/hank-claim-maker/guide/assigning-batches-and-cases/index.md)
- [Best Practices for File Uploads](https://docs.hank.ai/hank-claim-maker/guide/best-practices-for-file-uploads/index.md)
- [Claim Maker JSON Export Specification](https://docs.hank.ai/hank-claim-maker/guide/claim-maker-json-export-specification/index.md)
- [Creating Batches and Cases in CM LITE](https://docs.hank.ai/hank-claim-maker/guide/creating-batches-and-cases-in-cm-lite/index.md)
- [Data Entry Required Fields](https://docs.hank.ai/hank-claim-maker/guide/data-entry-required-fields/index.md)
- [Data Entry View Layout](https://docs.hank.ai/hank-claim-maker/guide/data-entry-view-layout/index.md)
- [First Time User Access Instructions](https://docs.hank.ai/hank-claim-maker/guide/first-time-user-access-instructions/index.md)
- [Line Item Validation](https://docs.hank.ai/hank-claim-maker/guide/line-item-validation/index.md)
- [Updated System Responses for Common Scenarios](https://docs.hank.ai/hank-claim-maker/guide/updated-system-responses-for-common-scenarios/index.md)
- [Adding a New Facility for Claim Maker LITE](https://docs.hank.ai/hank-claim-maker/guide/adding-a-new-facility-for-claim-maker-lite/index.md)
- [CSV Billing Export Spec](https://docs.hank.ai/hank-claim-maker/guide/csv-billing-export-spec/index.md)
- [Field Formatting Reference](https://docs.hank.ai/hank-claim-maker/guide/field-formatting-reference/index.md)
- [Getting Connected to Claim Maker](https://docs.hank.ai/hank-claim-maker/guide/getting-connected-to-claim-maker/index.md)
- [Keyboard Shortcuts for Line Items](https://docs.hank.ai/hank-claim-maker/guide/keyboard-shortcuts/index.md)
- [Manage Facility and Role Access](https://docs.hank.ai/hank-claim-maker/guide/manage-facility-and-role-access/index.md)
- [Move Documents](https://docs.hank.ai/hank-claim-maker/guide/move-a-document/index.md)
- [Resizable Panels](https://docs.hank.ai/hank-claim-maker/guide/resizable-panels/index.md)
- [Update Batch State](https://docs.hank.ai/hank-claim-maker/guide/update-batch-state/index.md)
- [Automatic Address Population using Zipcode](https://docs.hank.ai/hank-claim-maker/guide/automatic-address-population-using-zipcode/index.md)
- [Dark Mode](https://docs.hank.ai/hank-claim-maker/guide/dark-mode/index.md)
- [Delete a Document](https://docs.hank.ai/hank-claim-maker/guide/delete-a-document/index.md)
- [JSON Billing Export Spec](https://docs.hank.ai/hank-claim-maker/guide/json-billing-export-spec/index.md)
- [Managing Provider and Surgeon NPIs](https://docs.hank.ai/hank-claim-maker/guide/managing-provider-and-surgeon-npis/index.md)
- [Support Information](https://docs.hank.ai/hank-claim-maker/guide/support-information/index.md)
- [Update Case State and Reason](https://docs.hank.ai/hank-claim-maker/guide/update-case-state-and-reason/index.md)
- [Validating Claims](https://docs.hank.ai/hank-claim-maker/guide/validating-claims/index.md): Catch errors before a claim leaves the building.
- [Autocoding 2.0 Overview](https://docs.hank.ai/hank-claim-maker/guide/autocoding-2-0/index.md)
- [Customize Batch and Case States](https://docs.hank.ai/hank-claim-maker/guide/customize-batch-and-case-states/index.md)
- [Exporting Batches for Billing](https://docs.hank.ai/hank-claim-maker/guide/exporting-batches-for-billing/index.md)
- [Provider NPI and Advanced Search](https://docs.hank.ai/hank-claim-maker/guide/provider-npi-and-advanced-search/index.md)
- [Saving Insurances with IDs](https://docs.hank.ai/hank-claim-maker/guide/saving-insurances-with-ids/index.md)
- [Split Pages from a Document](https://docs.hank.ai/hank-claim-maker/guide/split-a-document/index.md)
- [User Settings](https://docs.hank.ai/hank-claim-maker/guide/user-settings/index.md)
- [AutoCoding Predictions](https://docs.hank.ai/hank-claim-maker/guide/autocoding-predictions/index.md)
- [Document Remediation](https://docs.hank.ai/hank-claim-maker/guide/document-remediation/index.md)
- [Filtering Batches and Cases](https://docs.hank.ai/hank-claim-maker/guide/filtering-batches-and-cases/index.md)
- [Removing Access to Claim Maker](https://docs.hank.ai/hank-claim-maker/guide/removing-access-to-claim-maker/index.md)
- [Human Review Elements (Autocoding 2.0)](https://docs.hank.ai/hank-claim-maker/guide/human-review-elements-autocoding-2-0/index.md)
- [Missing Documents](https://docs.hank.ai/hank-claim-maker/guide/missing-documents/index.md)
- [Saving Filter Sets](https://docs.hank.ai/hank-claim-maker/guide/saving-filter-sets/index.md)
- [Updating Facility Display Name](https://docs.hank.ai/hank-claim-maker/guide/updating-facility-display-name/index.md)
- [Adding Additional Times](https://docs.hank.ai/hank-claim-maker/guide/adding-additional-times/index.md)
- [Case Document Viewer](https://docs.hank.ai/hank-claim-maker/guide/case-document-viewer/index.md)
- [Move Case to Different Batch](https://docs.hank.ai/hank-claim-maker/guide/move-case-to-different-batch/index.md)
- [Updating ASA Crosswalks](https://docs.hank.ai/hank-claim-maker/guide/updating-asa-crosswalks/index.md)
- [Batch Documents and Notes](https://docs.hank.ai/hank-claim-maker/guide/batch-documents-and-notes/index.md)
- [Custom Fields](https://docs.hank.ai/hank-claim-maker/guide/custom-fields/index.md)
- [Delete a Batch](https://docs.hank.ai/hank-claim-maker/guide/delete-a-batch/index.md)
- [Audit Logs](https://docs.hank.ai/hank-claim-maker/guide/audit-logs/index.md)
- [Delete a Case](https://docs.hank.ai/hank-claim-maker/guide/delete-a-case/index.md)
- [Restore a Deleted Batch](https://docs.hank.ai/hank-claim-maker/guide/restore-a-deleted-batch/index.md)
- [Restore a Deleted Case inside a Batch](https://docs.hank.ai/hank-claim-maker/guide/restore-a-deleted-case-inside-a-batch/index.md)
- [Share Batch and Share Case Links](https://docs.hank.ai/hank-claim-maker/guide/share-batch-and-share-case-links/index.md)
- [Case Notes](https://docs.hank.ai/hank-claim-maker/guide/case-notes/index.md)
- [Claim Maker Work Queue](https://docs.hank.ai/hank-claim-maker/guide/claim-maker-work-queue/index.md)
- [Work Queue filtering](https://docs.hank.ai/hank-claim-maker/guide/work-queue-filtering/index.md)

### Release notes

- [Changelog](https://docs.hank.ai/hank-claim-maker/changelog): dated release notes for HANK Claim Maker.
- [Changelog API (JSON)](https://docs.hank.ai/api/changelog?product=hank-claim-maker): the machine-readable changelog feed.

## [HANK CODES](https://docs.hank.ai/hank-codes)

The autonomous medical coding platform.

- [Welcome to HANK CODES](https://docs.hank.ai/hank-codes/getting-started/welcome/index.md): What the HANK CODES platform is and how the pieces fit together.
- [Quickstart](https://docs.hank.ai/hank-codes/getting-started/quickstart/index.md): Get from zero to your first coded claim in a few minutes.

### Release notes

- [Changelog](https://docs.hank.ai/hank-codes/changelog): dated release notes for HANK CODES.
- [Changelog API (JSON)](https://docs.hank.ai/api/changelog?product=hank-codes): the machine-readable changelog feed.

## [HANK AutoCoder API](https://docs.hank.ai/hank-autocoder-api)

Autonomous coding, over an API.

- [Authentication](https://docs.hank.ai/hank-autocoder-api/api-reference/authentication/index.md): How to authenticate requests to the AutoCoder API.
- [Security](https://docs.hank.ai/hank-autocoder-api/api-reference/security/index.md): How the AutoCoder API is secured: firewall, SSL, and a per-customer API key.
- [POST Requests](https://docs.hank.ai/hank-autocoder-api/api-reference/post-for-autocoding-requests/index.md): Submit a clinical note for autonomous coding — the async POST that returns a task id.
- [GET Request](https://docs.hank.ai/hank-autocoder-api/api-reference/get-request/index.md): Poll a submitted task until it completes, and read the predicted codes.

### API specification

- [OpenAPI spec (JSON)](https://docs.hank.ai/hank-autocoder-api/openapi.json): the raw OpenAPI document for HANK AutoCoder API.