diff --git a/docs/api/permissions.mdx b/docs/api/permissions.mdx
index f809c6fe24906d..45d7fffd9d4a78 100644
--- a/docs/api/permissions.mdx
+++ b/docs/api/permissions.mdx
@@ -82,3 +82,9 @@ Events in Sentry are immutable and can only be deleted by deleting the whole iss
 Be aware that if you're using `sentry-cli` to [manage your releases](/cli/releases/), you'll need a token which also has `org:read` scope.
 
 </Alert>
+
+<Alert level="info" title="Project Access">
+
+In addition to the `project:releases` scope, mutations on releases (create, update, delete, file uploads, deploys) require that the user has access to **all** projects associated with the release. If your organization has [Open Membership](/organization/membership/#open-membership) disabled, members can only modify releases for projects belonging to teams they are a member of.
+
+</Alert>