diff --git a/.gitea/workflows/update_swagger.yaml b/.gitea/workflows/update_swagger.yaml
index 1ffc5e89..ae3fd003 100644
--- a/.gitea/workflows/update_swagger.yaml
+++ b/.gitea/workflows/update_swagger.yaml
@@ -2,7 +2,7 @@ name: update api spec files
 
 on:
   schedule:
-    - cron:  '0 */12 * * *' # every 12 hours on the hour
+    - cron: '0 3 * * 1' # every Monday at 03:00
   workflow_dispatch:
 
 env:
diff --git a/README.md b/README.md
index b80073ed..b9c27a37 100644
--- a/README.md
+++ b/README.md
@@ -79,7 +79,7 @@ make update-api-docs-latest  # refresh only the documents of gitea main
 ```
 
 The documents of gitea main are refreshed automatically: the `update api spec
-files` workflow runs every 12 hours and opens a pull request whenever gitea main
+files` workflow runs weekly and opens a pull request whenever gitea main
 changed. Released versions are updated by hand when a new gitea version is
 documented.