summaryrefslogtreecommitdiff
path: root/docs/federation/ratelimiting.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/federation/ratelimiting.md')
-rw-r--r--docs/federation/ratelimiting.md7
1 files changed, 7 insertions, 0 deletions
diff --git a/docs/federation/ratelimiting.md b/docs/federation/ratelimiting.md
new file mode 100644
index 000000000..36bd11985
--- /dev/null
+++ b/docs/federation/ratelimiting.md
@@ -0,0 +1,7 @@
+# Request Throttling & Rate Limiting
+
+GoToSocial applies http request throttling and rate limiting to the ActivityPub API endpoints (inboxes, user endpoints, emojis, etc).
+
+This ensures that remote servers cannot flood a GoToSocial instance with spurious requests. Instead, remote servers making GET or POST requests to the ActivityPub API endpoints should respect 429 and 503 http codes, and take account of the `retry-after` http response header.
+
+For more details on request throttling and rate limiting behavior, please see the [throttling](../api/throttling.md) and [rate limiting](../api/ratelimiting.md) documents.