diff --git a/.changeset/perfect-clocks-look.md b/.changeset/perfect-clocks-look.md
new file mode 100644
index 000000000..0aeb0b8fe
--- /dev/null
+++ b/.changeset/perfect-clocks-look.md
@@ -0,0 +1,5 @@
+---
+'@gitbook/api': patch
+---
+
+Document the @gitbook/api package and update the OpenAPI spec