# Machine surfaces at the root

> Every file a machine finds at the root of openhelvetia.swiss, with format, purpose and pointer.


Every surface sits language-neutral at the root of the one entry. The column «Pointer» names the key under which `/.well-known/openhelvetia.json` lists it.

| Path | Format | Purpose | Pointer |
|---|---|---|---|
| `/.well-known/openhelvetia.json` | JSON | identity and pointers, the root facade | — |
| `/directory.json` | JSON | directory index, envelope v0.2, `authority = manifest` | `directory` |
| `/directory/{slug}/manifest.json` | JSON-LD | byte-identical copy of the registry source per entry | — |
| `/modules.json` | JSON | the platform's modules as data: state, evidence, commands, contracts | — |
| `/.well-known/api-catalog` | RFC 9727 | linkset catalogue of the machine surfaces | `api-catalog` |
| `/.well-known/agent-card.json` | A2A 1.0 | the association's agent card; no A2A endpoint in operation | `agent-card` |
| `/catalog.jsonld` · `/catalog.ttl` | DCAT-AP-CH | catalogue, one graph in two serialisations | `catalog` |
| `/llms.txt` | text | orientation for language models, bilingual | `llms` |
| `/pages.json` | JSON | every page of this website with title and purpose | `pages` |
| `/org/openhelvetia.ttl` · `.jsonld` | RDF | the association's time-model data | — |
| `/.well-known/security.txt` | RFC 9116 | contact and expiry | `security` |
| `/ns/manifest/v1` | JSON-LD | JSON-LD context v1 | — |
| `/ns/manifest/schema/2026-08-15/manifest.schema.json` | JSON Schema 2020-12 | dated manifest schema | `standard` |
| `/ns/directory/0.2/schema` · `/ns/card/0.1/schema` | JSON Schema 2020-12 | envelope and card schema | — |

The identifiers of the standard's artifacts are on `ld.openhelvetia.swiss`; this website serves mirror copies under `/ns/`. Ontology, SHACL shapes and frame have no serving path today. The tenth pointer, `oauth-protected-resource`, points at the gateway's RFC 9728 metadata: prepared, not served. Every page of this documentation also exists as Markdown beside its HTML (`index.md`).

---

Source: docs/en/reference/machine-surfaces.md