Merge pull request #151 from buildkite/buildkite-docs-bot/graphql/03f…

…dc234

Update GraphQL docs

data/graphql/schema.graphql

@@ -188,6 +188,11 @@ type Agent implements Node {
     Returns the elements in the list that come after the specified cursor.
     """
     after: String
+
+    """
+    Filter jobs based on matching agent query rules (for example, a single tag
+    match "queue=test", or an array of matches ["queue=test", "tag=value"])
+    """
     agentQueryRules: [String!]
 
     """
@@ -1267,6 +1272,11 @@ type Build implements Node {
     Returns the elements in the list that come after the specified cursor.
     """
     after: String
+
+    """
+    Filter jobs based on matching agent query rules (for example, a single tag
+    match "queue=test", or an array of matches ["queue=test", "tag=value"])
+    """
     agentQueryRules: [String!]
 
     """
@@ -2156,11 +2166,6 @@ type ClusterQueueConnection implements Connection {
 Autogenerated input type of ClusterQueueCreate
 """
 input ClusterQueueCreateInput {
-  """
-  The hosted agent architecture for the queue
-  """
-  architecture: HostedAgentArchitecture
-
   """
   A unique identifier for the client performing the mutation.
   """
@@ -2178,20 +2183,15 @@ input ClusterQueueCreateInput {
   hosted: Boolean
 
   """
-  The queue tag used to connect an agent to the queue, this can't be updated later
+  Hosted agent instance shape
   """
-  key: String!
+  instanceShape: HostedAgentInstanceShapeName
 
   """
-  The hosted agent machine type for the queue
+  The queue tag used to connect an agent to the queue, this can't be updated later
   """
-  machineType: HostedAgentMachineType
+  key: String!
   organizationId: ID!
-
-  """
-  The hosted agent size for the queue
-  """
-  size: HostedAgentSize
 }
 
 """
@@ -2341,12 +2341,12 @@ input ClusterQueueUpdateInput {
   """
   description: String
   id: ID!
-  organizationId: ID!
 
   """
-  The hosted agent size for the queue
+  Hosted agent instance shape
   """
-  size: HostedAgentSize
+  instanceShape: HostedAgentInstanceShapeName
+  organizationId: ID!
 }
 
 """
@@ -2709,6 +2709,91 @@ enum HostedAgentArchitecture {
   ARM64
 }
 
+"""
+Possible instance shapes for the hosted agent instance
+"""
+enum HostedAgentInstanceShapeName {
+  """
+  Linux 16 vCPU x 64 GB Memory
+  """
+  LINUX_AMD64_16X64
+
+  """
+  Linux 2 vCPU x 4 GB Memory
+  """
+  LINUX_AMD64_2X4
+
+  """
+  Linux 4 vCPU x 16 GB Memory
+  """
+  LINUX_AMD64_4X16
+
+  """
+  Linux 4 vCPU x 8 GB Memory (Deprecated)
+  """
+  LINUX_AMD64_4X8
+
+  """
+  Linux 8 vCPU x 16 GB Memory (Deprecated)
+  """
+  LINUX_AMD64_8X16
+
+  """
+  Linux 8 vCPU x 32 GB Memory
+  """
+  LINUX_AMD64_8X32
+
+  """
+  Linux 16 vCPU x 64 GB Memory
+  """
+  LINUX_ARM64_16X64
+
+  """
+  Linux 2 vCPU x 4 GB Memory
+  """
+  LINUX_ARM64_2X4
+
+  """
+  Linux 4 vCPU x 16 GB Memory
+  """
+  LINUX_ARM64_4X16
+
+  """
+  Linux 4 vCPU x 8 GB Memory (Deprecated)
+  """
+  LINUX_ARM64_4X8
+
+  """
+  Linux 8 vCPU x 16 GB Memory (Deprecated)
+  """
+  LINUX_ARM64_8X16
+
+  """
+  Linux 8 vCPU x 32 GB Memory
+  """
+  LINUX_ARM64_8X32
+
+  """
+  macOS 12 vCPU x 28 GB Memory
+  """
+  MACOS_M2_12X28
+
+  """
+  macOS 4 vCPU x 7 GB Memory
+  """
+  MACOS_M2_4X7
+
+  """
+  macOS 6 vCPU x 14 GB Memory
+  """
+  MACOS_M2_6X14
+
+  """
+  macOS 12 vCPU x 56 GB Memory
+  """
+  MACOS_M4_12X56
+}
+
 """
 Possible machine types for the hosted agent instance
 """
@@ -5293,6 +5378,11 @@ type Organization implements Node {
     Returns the elements in the list that come after the specified cursor.
     """
     after: String
+
+    """
+    Filter jobs based on matching agent query rules (for example, a single tag
+    match "queue=test", or an array of matches ["queue=test", "tag=value"])
+    """
     agentQueryRules: [String!]
 
     """
@@ -6944,6 +7034,11 @@ type Pipeline implements Node {
     Returns the elements in the list that come after the specified cursor.
     """
     after: String
+
+    """
+    Filter jobs based on matching agent query rules (for example, a single tag
+    match "queue=test", or an array of matches ["queue=test", "tag=value"])
+    """
     agentQueryRules: [String!]
 
     """
@@ -11955,6 +12050,11 @@ type Viewer implements Node {
   id: ID!
   jobs(
     after: String
+
+    """
+    Filter jobs based on matching agent query rules (for example, a single tag
+    match "queue=test", or an array of matches ["queue=test", "tag=value"])
+    """
     agentQueryRules: [String!]
     before: String
     first: Int

data/nav_graphql.yml

@@ -918,6 +918,8 @@
     path: apis/graphql/schemas/enum/clusterqueueorder
   - name: HostedAgentArchitecture
     path: apis/graphql/schemas/enum/hostedagentarchitecture
+  - name: HostedAgentInstanceShapeName
+    path: apis/graphql/schemas/enum/hostedagentinstanceshapename
   - name: HostedAgentMachineType
     path: apis/graphql/schemas/enum/hostedagentmachinetype
   - name: HostedAgentSize