diff --git a/doc/developers/api-usage.en-us.md b/doc/developers/api-usage.en-us.md
index 5253cbaa..15fedbe2 100644
--- a/doc/developers/api-usage.en-us.md
+++ b/doc/developers/api-usage.en-us.md
@@ -79,6 +79,9 @@ API Reference guide is auto-generated by swagger and available on:
 or on
 [gitea demo instance](https://try.gitea.io/api/swagger)
 
+The OpenAPI document is at:
+`https://gitea.your.host/swagger.v1.json`
+
 ## Listing your issued tokens via the API
 
 As mentioned in