Merge pull request #2487 from buildkite/buildkite-docs-bot/graphql/64…

…515585

Update GraphQL docs

data/graphql/schema.graphql

@@ -4085,16 +4085,6 @@ type Mutation {
     input: OrganizationAPIIPAllowlistUpdateMutationInput!
   ): OrganizationAPIIPAllowlistUpdateMutationPayload
 
-  """
-  Create a System banner within an organization
-  """
-  organizationBannerCreate(
-    """
-    Parameters for OrganizationBannerCreate
-    """
-    input: OrganizationBannerCreateInput!
-  ): OrganizationBannerCreatePayload
-
   """
   Delete a System banner
   """
@@ -4106,14 +4096,16 @@ type Mutation {
   ): OrganizationBannerDeletePayload
 
   """
-  Update System banner within an organization
+  Retrieves the active system banner for provided organization, then updates it
+  with input data. If active banner is not found, a new banner is created with
+  the provided input.
   """
-  organizationBannerUpdate(
+  organizationBannerUpsert(
     """
-    Parameters for OrganizationBannerUpdate
+    Parameters for OrganizationBannerUpsert
     """
-    input: OrganizationBannerUpdateInput!
-  ): OrganizationBannerUpdatePayload
+    input: OrganizationBannerUpsertInput!
+  ): OrganizationBannerUpsertPayload
 
   """
   Sets whether the organization requires two-factor authentication for all members.
@@ -5380,30 +5372,6 @@ type OrganizationBannerConnection {
   pageInfo: PageInfo!
 }
 
-"""
-Autogenerated input type of OrganizationBannerCreate
-"""
-input OrganizationBannerCreateInput {
-  """
-  A unique identifier for the client performing the mutation.
-  """
-  clientMutationId: String
-  message: String!
-  organizationId: ID!
-}
-
-"""
-Autogenerated return type of OrganizationBannerCreate.
-"""
-type OrganizationBannerCreatePayload {
-  banner: OrganizationBanner!
-
-  """
-  A unique identifier for the client performing the mutation.
-  """
-  clientMutationId: String
-}
-
 """
 Autogenerated input type of OrganizationBannerDelete
 """
@@ -5442,21 +5410,21 @@ type OrganizationBannerEdge {
 }
 
 """
-Autogenerated input type of OrganizationBannerUpdate
+Autogenerated input type of OrganizationBannerUpsert
 """
-input OrganizationBannerUpdateInput {
+input OrganizationBannerUpsertInput {
   """
   A unique identifier for the client performing the mutation.
   """
   clientMutationId: String
-  id: ID!
   message: String!
+  organizationId: ID!
 }
 
 """
-Autogenerated return type of OrganizationBannerUpdate.
+Autogenerated return type of OrganizationBannerUpsert.
 """
-type OrganizationBannerUpdatePayload {
+type OrganizationBannerUpsertPayload {
   banner: OrganizationBanner!
 
   """

data/nav_graphql.yml

@@ -119,12 +119,10 @@
     path: apis/graphql/schemas/mutation/organizationapiaccesstokenrevoke
   - name: organizationApiIpAllowlistUpdate
     path: apis/graphql/schemas/mutation/organizationapiipallowlistupdate
-  - name: organizationBannerCreate
-    path: apis/graphql/schemas/mutation/organizationbannercreate
   - name: organizationBannerDelete
     path: apis/graphql/schemas/mutation/organizationbannerdelete
-  - name: organizationBannerUpdate
-    path: apis/graphql/schemas/mutation/organizationbannerupdate
+  - name: organizationBannerUpsert
+    path: apis/graphql/schemas/mutation/organizationbannerupsert
   - name: organizationEnforceTwoFactorAuthenticationForMembersUpdate
     path: apis/graphql/schemas/mutation/organizationenforcetwofactorauthenticationformembersupdate
   - name: organizationInvitationCreate
@@ -463,14 +461,12 @@
     path: apis/graphql/schemas/object/organizationbanner
   - name: OrganizationBannerConnection
     path: apis/graphql/schemas/object/organizationbannerconnection
-  - name: OrganizationBannerCreatePayload
-    path: apis/graphql/schemas/object/organizationbannercreatepayload
   - name: OrganizationBannerDeletePayload
     path: apis/graphql/schemas/object/organizationbannerdeletepayload
   - name: OrganizationBannerEdge
     path: apis/graphql/schemas/object/organizationbanneredge
-  - name: OrganizationBannerUpdatePayload
-    path: apis/graphql/schemas/object/organizationbannerupdatepayload
+  - name: OrganizationBannerUpsertPayload
+    path: apis/graphql/schemas/object/organizationbannerupsertpayload
   - name: OrganizationConnection
     path: apis/graphql/schemas/object/organizationconnection
   - name: OrganizationEdge
@@ -973,12 +969,10 @@
     path: apis/graphql/schemas/input-object/organizationapiaccesstokenrevokemutationinput
   - name: OrganizationAPIIPAllowlistUpdateMutationInput
     path: apis/graphql/schemas/input-object/organizationapiipallowlistupdatemutationinput
-  - name: OrganizationBannerCreateInput
-    path: apis/graphql/schemas/input-object/organizationbannercreateinput
   - name: OrganizationBannerDeleteInput
     path: apis/graphql/schemas/input-object/organizationbannerdeleteinput
-  - name: OrganizationBannerUpdateInput
-    path: apis/graphql/schemas/input-object/organizationbannerupdateinput
+  - name: OrganizationBannerUpsertInput
+    path: apis/graphql/schemas/input-object/organizationbannerupsertinput
   - name: OrganizationEnforceTwoFactorAuthenticationForMembersUpdateMutationInput
     path: apis/graphql/schemas/input-object/organizationenforcetwofactorauthenticationformembersupdatemutationinput
   - name: OrganizationInvitationCreateInput