diff --git a/docs/api.mdx b/docs/api.mdx
index 7ed2f2e7d..f293d53cb 100644
--- a/docs/api.mdx
+++ b/docs/api.mdx
@@ -36,6 +36,7 @@ The API uses standard HTTP response codes.
 - **`402`**: Payment required (organization disabled or usage exceeded)
 - **`403`**: Forbidden (insufficient permissions)
 - **`404`**: Not found
+- **`408`**: Request Timeout
 - **`409`**: Conflict
 - **`429`**: Too many requests (rate limit exceeded, no state change, or selective throttling)
 - **`451`**: Unavailable for legal reasons (country blocklisted)