Wagtail API

Wagtail includes a built-in API module, currently with two coexisting versions for programmatic access to your content:

  • v2: a battle-tested read-only API, built on Django REST Framework. It exposes content as raw field data for serving content to non-web clients (such as a mobile phone app), or pulling content out of Wagtail for use in another site. It’s widely used for headless projects.

  • v3 — Wagtail 8.0’s new API, built on Django Ninja. Beyond reading content, it supports a wide range of authenticated CMS operations such as creating and editing pages, media, documents, and snippets, plus revisions, rich text, and StreamField. It offers OpenAPI 3.1 schema output and RFC 7807 errors.

See RFC 8: Wagtail API for full details on our stabilization policy.

Wagtail is built on Django, so you can also use other Django solutions for building APIs such as with Django Ninja or with GraphQL.

The v2 read API remains available and unchanged, while v3 is under active development. See the configuration guides below for more usage information.