API and agent access

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 endpoint
• GET /api/v1/openapi.json - OpenAPI 3.1 spec for the whole API
• GET /api/v1/courses.json - List all courses with their lessons
• GET /api/v1/courses/{slug}.json - A single course with full lesson list
• GET /api/v1/lessons.json - All lessons as metadata
• GET /api/v1/lessons/{slug}.json - Full detail for a single lesson
• GET /api/v1/fundamentals.json - All beginner reference pages
• GET /api/v1/articles.json - All knowledge articles
• GET /api/v1/builds.json - All founder project case studies
• GET /api/v1/resources.json - All resources with full content
• GET /api/v1/changelog.json - All tool-news changelog entries
• GET /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.txt

Markdown 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.

Quick links

• llms.txt
• llms-full.txt
• OpenAPI 3.1
• API discovery document with every endpoint