---
title: "Get Schema"
method: GET
path: "/v1/schema"
tags: ["schema"]
---

# Get Schema

`GET /v1/schema`

## Request

- Base URL: `https://api.heirmos.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.heirmos.com/v1/schema`
- Auth: HTTP bearer

Return the user's SCHEMA.md.

If the user has never PUT a schema, return an empty seed (content="", version=0)
rather than 404 — SPEC §5.3 response shape is always a single object, and the
spec text says this endpoint "must be called before storing memory", so 404
would force every AI client to special-case bootstrap.

## Response `200`

Successful Response

- SchemaRead: GET /v1/schema response — SPEC §5.3 line 277-283.
  - `content` string, required
  - `version` integer, required
  - `updated_at` string, date-time, required

---

[API](https://skmtc.dev/heirmos/apis/heirmos-api.md) · [All operations](https://skmtc.dev/heirmos/apis/heirmos-api/llms.txt) · [OpenAPI document](https://skmtc.dev/heirmos/apis/heirmos-api/revisions/ed490b1866e7?raw)