# API Documentation | Kroonen AI

> Public API for the Kroonen AI lab: a read-only Genesis 1B training status feed and a Turnstile-gated contact endpoint. OpenAPI specification and agent discovery documents are published alongside.

Canonical: https://www.kroonen.ai/docs/api/

/docs/api

# API Documentation

The public Kroonen AI surface is small and intentionally so. A read-only telemetry endpoint streams the Genesis 1B training run, and a Turnstile-gated endpoint delivers contact messages. Everything below is documented in an OpenAPI 3.1 specification and is discoverable through the site's machine-readable catalog.

[

Catalog

API Catalog

](https://www.kroonen.ai/.well-known/api-catalog)[

Spec

OpenAPI 3.1

](https://www.kroonen.ai/docs/openapi.json)[

Auth

auth.md

](https://www.kroonen.ai/auth.md)

GET `/api/genesis-status` None (public)

## Genesis 1B training status

Returns the current training step, most recent loss, run state, and an ETA for the Genesis 1B one-billion-parameter run. Cached for 60 seconds. Safe for polling.

Example response

```
{
  "step": 41233,
  "loss": 2.7311,
  "state": "running",
  "etaMs": 1787000000000
}
```

POST `/api/contact` Turnstile-gated

## Submit a contact message

Delivers a contact-form message via email. Requires a valid Cloudflare Turnstile token (action "contact") and a JSON body. This endpoint is intentionally human-gated and is not a target for automated agents; use it to reach a person.

Example response

```
{
  "success": true,
  "message": "Message sent successfully!"
}
```

## Agent discovery documents

Kroonen AI publishes a full set of machine-readable discovery documents so autonomous agents can find, authenticate to, and use the site. They are linked from the homepage via `Link` response headers (RFC 8288).

-   `/.well-known/api-catalog` — RFC 9727 linkset catalog of the API.
-   `/docs/openapi.json` — OpenAPI 3.1 specification.
-   `/.well-known/oauth-authorization-server` — OAuth 2.0 metadata (RFC 8414).
-   `/.well-known/oauth-protected-resource` — protected resource metadata (RFC 9728).
-   `/auth.md` — agent registration instructions.
-   `/.well-known/mcp/server-card.json` — MCP server card (SEP-1649).
-   `/.well-known/agent-skills/index.json` — agent skills discovery index.
-   `/.well-known/ai-catalog.json` — ARD agentic resource manifest.