---
title: "State Schema"
html_title: "Enroll State Schema"
description: "The current JSON schema for Enroll harvest state.json bundles."
---
<header class="py-5 hero">
  <div class="container py-3">
    <div class="kicker mb-3"><i class="bi bi-braces"></i> Schema</div>
    <h1 class="display-6 fw-bold mb-2">Harvest <code>state.json</code> schema</h1>
    <p class="lead mb-0">The schema below is served from <code>/schema/state.schema.json</code> and should match the schema vendored with the current Enroll codebase.</p>
  </div>
</header>

<main class="py-5">
  <div class="container">
    <div class="feature-card p-4 mb-4">
      <h2 class="h4 fw-bold mb-2">Validation behavior</h2>
      <p><code>enroll validate</code> uses the vendored schema by default. You may pass a local schema path with <code>--schema</code>. HTTP(S) schemas are blocked unless <code>--allow-remote-schema</code> is explicitly set.</p>
      <div class="terminal"><pre class="mb-0"><code>enroll validate ./harvest
enroll validate ./harvest --schema ./state.schema.json
enroll validate ./harvest --schema https://enroll.sh/schema/state.schema.json --allow-remote-schema
enroll validate ./harvest --no-schema</code></pre></div>
    </div>

    <div class="feature-card p-4">
      <div class="d-flex align-items-center justify-content-between gap-3 mb-3">
        <h2 class="h4 fw-bold mb-0">Current schema</h2>
        <a class="btn btn-sm btn-outline-dark" href="schema/state.schema.json"><i class="bi bi-download"></i> Open JSON</a>
      </div>
      <pre class="terminal mb-0" style="max-height: 70vh; overflow:auto;"><code id="schema-code">Loading schema…</code></pre>
    </div>
  </div>
</main>

<script>
(async () => {
  const el = document.getElementById('schema-code');
  try {
    const res = await fetch('schema/state.schema.json', {cache: 'no-store'});
    const obj = await res.json();
    el.textContent = JSON.stringify(obj, null, 2);
  } catch (e) {
    el.textContent = 'Failed to load schema: ' + (e && e.message ? e.message : String(e));
  }
})();
</script>