diff --git a/api/funkwhale_api/common/schema.yml b/api/funkwhale_api/common/schema.yml
index 9970d42fd..8289537e5 100644
--- a/api/funkwhale_api/common/schema.yml
+++ b/api/funkwhale_api/common/schema.yml
@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: Funkwhale API
-  version: 2.0.0a1
+  version: 2.0.0a2
   description: |
     # Funkwhale API
 
diff --git a/docs/developer/workflows/release.md b/docs/developer/workflows/release.md
index 9e519d763..c80090249 100644
--- a/docs/developer/workflows/release.md
+++ b/docs/developer/workflows/release.md
@@ -58,6 +58,8 @@ Once we're ready to release a new version of the software, we can use the follow
 7. Update the next release version
 
    ```sh
+   docker compose build api
+   docker compose run --rm api funkwhale-manage spectacular > ./api/funkwhale_api/common/schema.yml
    cd api
    poetry version "$NEXT_RELEASE"
    cd ..