Conventions
- Append .md to any content URL to get clean Markdown with frontmatter (title, description, locale, canonical, dates). Example: /courses/foundations.md
- The read-only JSON API lives under /api/v1. German content is served under /api/v1/de.
- Discover everything machine-readable from /llms.txt (English) or /de/llms.txt (German); /llms-full.txt is the full corpus in one document.
- Every JSON payload carries a stable schema, a locale field and canonical site URLs.
Endpoints
GET /api/v1/index.json- API discovery document with every endpointGET /api/v1/openapi.json- OpenAPI 3.1 spec for the whole APIGET /api/v1/courses.json- List all courses with their lessonsGET /api/v1/courses/{slug}.json- A single course with full lesson listGET /api/v1/lessons.json- All lessons as metadataGET /api/v1/lessons/{slug}.json- Full detail for a single lessonGET /api/v1/fundamentals.json- All beginner reference pagesGET /api/v1/articles.json- All knowledge articlesGET /api/v1/builds.json- All founder project case studiesGET /api/v1/resources.json- All resources with full contentGET /api/v1/changelog.json- All tool-news changelog entriesGET /api/v1/search-index.json- Flat search index for client or agent search
Examples
curl https://agenticschool.dev/api/v1/courses.json
curl https://agenticschool.dev/api/v1/lessons/your-first-project-scaffolding-dev-server-git-and-github.json
curl https://agenticschool.dev/courses/foundations.md
curl https://agenticschool.dev/llms.txtMarkdown for any page
Every course, lesson, knowledge article, fundamental, build, resource and changelog entry has a Markdown twin at its human URL plus a .md suffix, in both locales. Content pages also advertise it with a <link rel="alternate" type="text/markdown"> tag.
Fair use
This surface is fully static and served from a CDN, so there are no hard rate limits. Please cache responses, prefer the JSON and .md endpoints over scraping HTML, identify your agent with a descriptive User-Agent, and use /llms-full.txt for a one-shot full corpus instead of crawling every page. A courtesy ceiling of around 60 requests per minute keeps the surface healthy for everyone.
