diff --git a/pages/apis/graphql/cookbooks/organizations.md b/pages/apis/graphql/cookbooks/organizations.md index 23eb3ba60a..5d2e661f89 100644 --- a/pages/apis/graphql/cookbooks/organizations.md +++ b/pages/apis/graphql/cookbooks/organizations.md @@ -126,6 +126,27 @@ mutation UpdateSessionIPAddressPinning { } ``` +## Enforce 2FA for your organization + +Require users to have 2FA enabled before they can access your organization Buildkite dashboard. + +```graphql +mutation EnableEnforced2FA { + organizationEnforceTwoFactorAuthenticationForMembersUpdate( + input: { + organizationId: "organization-id", + membersRequireTwoFactorAuthentication: true + } + ) { + organization { + id + membersRequireTwoFactorAuthentication + uuid + } + } +} +``` + ## Query the usage API Use the usage API to query your organization's usage by pipeline or test suite at daily granularity.