# Aignostics

> Aignostics GmbH (Berlin, Germany) builds AI foundation models and analysis applications for
> computational pathology. Its commercial surface is the Aignostics Platform: a cloud service that
> runs pathology applications - Atlas H&E-TME tumor-microenvironment profiling is the flagship - over
> whole slide images on dedicated GPU infrastructure, reachable through a browser Console, an
> open-source Python SDK, and a public REST API.

This file was generated by API Evangelist from Aignostics' own public surface on 2026-09-14.
Aignostics does not publish an llms.txt of its own (probed: aignostics.com, www.aignostics.com,
platform.aignostics.com and aignostics.readthedocs.io - all miss).

## API at a glance

- Name: Aignostics Platform API
- Base URL: https://platform.aignostics.com/api/v1
- Contract: OpenAPI 3.1.0, info.version 1.8.0, 26 operations, 45 schemas
- Contract URL (public, unauthenticated): https://platform.aignostics.com/api/v1/openapi.json
- Interactive console: https://platform.aignostics.com/api/v1/docs (ReDoc at /api/v1/redoc)
- Auth: OAuth 2.0 bearer. Authorization-code and device-code (RFC 8628) flows against
  https://aignostics-platform.eu.auth0.com. No anonymous access, no API keys.
- Onboarding: an organization must be registered by Aignostics; a client_id is issued by
  support@aignostics.com. There is no self-serve signup that yields API access.

## Documentation

- Developer docs home: https://aignostics.readthedocs.io/en/latest/
- Get started with the API: https://aignostics.readthedocs.io/en/latest/get_started_api.html
- Get started with the Python library: https://aignostics.readthedocs.io/en/latest/get_started_library.html
- Get started with the Console: https://aignostics.readthedocs.io/en/latest/get_started_console.html
- API v1 explorer: https://aignostics.readthedocs.io/en/latest/api_explorer_v1.html
- Library reference: https://aignostics.readthedocs.io/en/latest/lib_reference.html
- Platform overview: https://aignostics.readthedocs.io/en/latest/platform_overview.html
- Release notes: https://aignostics.readthedocs.io/en/latest/release-notes.html
- Security policy: https://aignostics.readthedocs.io/en/latest/security.html
- Troubleshooting: https://aignostics.readthedocs.io/en/latest/troubleshooting.html
- Glossary: https://aignostics.readthedocs.io/en/latest/glossary.html

## Operations

Applications and versions
- GET /v1/applications - list applications the caller's organization is entitled to
- GET /v1/applications/{application_id} - application detail
- GET /v1/applications/{application_id}/versions/{version} - the per-version contract: accepted input
  artifacts, their MIME types and metadata JSON Schema, and the output artifacts produced
- GET /v1/applications/{application_id}/versions/{version}/documents - public version documents
- GET .../documents/{name}, .../{name}/file, .../{name}/content - document metadata, download, stream

Runs
- POST /v1/runs - submit slides for analysis. BILLABLE. Not idempotent.
- GET /v1/runs - list runs (filter by application, version, external_id, submitter, organization, and
  by PostgreSQL JSONPath over custom_metadata)
- GET /v1/runs/{run_id} - run state, termination reason, per-state item statistics
- POST /v1/runs/{run_id}/cancel - cancel; pending items are not processed and do not add to the cost
- GET /v1/runs/{run_id}/items - per-slide state and results, paginated
- GET /v1/runs/{run_id}/items/{external_id} - one slide by the caller's own identifier
- GET /v1/runs/{run_id}/artifacts/{artifact_id}/file - 307 to a short-lived signed storage URL
- DELETE /v1/runs/{run_id}/artifacts - delete outputs. Irreversible. Only after TERMINATED.
- PUT /v1/runs/{run_id}/custom-metadata - overwrite run metadata, optional checksum precondition
- PUT /v1/runs/{run_id}/items/{external_id}/custom-metadata - same, per item

Sharing
- POST /v1/access/grants, GET /v1/access/grants, GET/DELETE /v1/access/grants/{grant_id}
- POST /v1/access/share-tokens, GET /v1/access/share-tokens,
  GET/DELETE /v1/access/share-tokens/{share_token_id}

Identity
- GET /v1/me - user and organization. Returns live storage credentials; do not log or cache it.

## Things an agent must know before calling this API

- POST /v1/runs is NOT idempotent. Calling it twice analyzes the slides twice and bills twice. There
  is no Idempotency-Key header anywhere in the contract. Record the run_id before retrying.
- Every costly or destructive write has a named reversal with a stated window: cancel a run any time
  before TERMINATED; revoke a grant or share token at any time; artifact deletion is the exception -
  it is irreversible and 410s afterwards.
- Output artifacts are deleted automatically 30 days after a run finishes. Retrieve inside that window.
- Retry 5xx, timeouts and connection errors with exponential backoff and jitter. Never retry a 4xx.
- 402 Payment Required is the quota signal on POST /v1/runs (slides per run, or monthly slides). There
  is no 429 and no rate-limit headers.
- Only 422 has a parseable error body. Everything else is a status code and English prose.
- Pin version_number on a run if results must be reproducible; omitting it selects the latest version.
- GET /v1/applications spells the page parameter `page-size`; everywhere else it is `page_size`.

## SDKs and tools

- Python SDK (Launchpad desktop app, CLI, client library, stdio MCP server):
  https://pypi.org/project/aignostics/ - v1.5.0, 2026-08-13, MIT,
  source https://github.com/aignostics/python-sdk
- TypeScript SDK: https://www.npmjs.com/package/@aignostics/sdk - v3.8.1, 2026-07-29
- TypeScript CLI: https://www.npmjs.com/package/@aignostics/cli - v4.0.0, 2026-07-29
- GitHub organization: https://github.com/aignostics
- MCP server: ships inside the Python SDK, stdio transport only (`uv run aignostics mcp run`). There
  is no hosted MCP endpoint, and the customer-facing MCP guide is currently withdrawn.

## Operations and status

- Status page: https://status.aignostics.com/ (Better Stack; JSON at /index.json, RSS at /feed.rss)
- Support: support@aignostics.com - https://www.aignostics.com/contact
- Security reports: https://github.com/aignostics/python-sdk/security/advisories/new

## Company

- Website: https://www.aignostics.com/
- Products: Atlas H&E-TME, PathoSearch, foundation models -
  https://www.aignostics.com/products
- Blog: https://www.aignostics.com/blog - News: https://www.aignostics.com/news
- Publications: https://www.aignostics.com/publications
- Legal: Aignostics GmbH, Alt-Moabit 73/73A, 10555 Berlin - https://www.aignostics.com/impressum
- Privacy: https://www.aignostics.com/privacy-policy

## Free and academic access

- Research Access Program (no cost, application reviewed on scientific merit):
  https://www.aignostics.com/products/atlas-he-tme/for-academics
- OpenTME open-access outputs, explored with https://github.com/aignostics/tme-studio

## Not published

- No pricing page; no plan or per-slide price is public (https://www.aignostics.com/pricing is 404)
- No terms of service page
- No /.well-known/security.txt, api-catalog, agent-card.json or apis.json on any Aignostics host
- No AsyncAPI document and no documented webhook surface, though the contract references
  "state-change events"
- No published OAuth scopes; the securityScheme declares an empty scopes object