---
title: "CreateRuntimeGroupRequest"
url: "https://nov18-dev.movespot.fyi/apis/konnect-runtime-groups-internal-2/versions/e185700f-0c72-40ae-9fcc-28365e70ba27/schemas/CreateRuntimeGroupRequest"
---

> Full API specification: https://nov18-dev.movespot.fyi/apis/konnect-runtime-groups-internal-2/versions/e185700f-0c72-40ae-9fcc-28365e70ba27.md

# CreateRuntimeGroupRequest

The request schema for the create runtime group request.

## OpenAPI definition

```yaml
openapi: 3.0.0
info:
  title: Konnect Runtime Groups
  version: 2.0.0
servers:
  - url: https://us.api.konghq.com/v2
    description: United-States Production region
  - url: https://eu.api.konghq.com/v2
    description: Europe Production region
  - url: https://au.api.konghq.com/v2
    description: Australia Production region
  - url: https://me.api.konghq.com/v2
    description: Middle-East Production region
  - url: https://in.api.konghq.com/v2
    description: India Production region
  - url: https://sg.api.konghq.com/v2
    description: Singapore Production region
components:
  schemas:
    ProxyURLs:
      description: Array of proxy URLs associated with reaching the data-planes
        connected to a runtime group.
      type: array
      items:
        $ref: "#/components/schemas/ProxyURL"
      example:
        - host: example.com
          port: 443
          protocol: https
      title: ProxyURLs
    Labels:
      description: Labels to facilitate tagged search on runtime groups. Keys must be
        of length 1-63 characters, and cannot start with 'kong', 'konnect',
        'mesh', 'kic', or '_'.
      type: object
      example:
        test: "true"
      additionalProperties:
        type: string
        pattern: ^[a-z0-9A-Z]{1}([a-z0-9A-Z\-\.\_]*[a-z0-9A-Z]+)?$
        minLength: 1
        maxLength: 63
      title: Labels
    ProxyURL:
      description: Proxy URL associated with reaching the data-planes connected to a
        runtime group.
      type: object
      properties:
        host:
          description: Hostname of the proxy URL.
          type: string
        port:
          description: Port of the proxy URL.
          type: integer
        protocol:
          description: Protocol of the proxy URL.
          type: string
      example:
        host: example.com
        port: 443
        protocol: https
      additionalProperties: false
      required:
        - host
        - port
        - protocol
      title: ProxyURL
    CreateRuntimeGroupRequest:
      description: The request schema for the create runtime group request.
      type: object
      properties:
        name:
          description: The name of the runtime group.
          type: string
          example: Test Runtime Group
        description:
          description: The description of the runtime group in Konnect.
          type: string
          example: A test runtime group for exploration.
        cluster_type:
          description: The ClusterType value of the cluster associated with the Runtime
            Group.
          type: string
          example: CLUSTER_TYPE_HYBRID
          enum:
            - CLUSTER_TYPE_HYBRID
            - CLUSTER_TYPE_K8S_INGRESS_CONTROLLER
            - CLUSTER_TYPE_COMPOSITE
            - CLUSTER_TYPE_SERVERLESS
            - CLUSTER_TYPE_KAFKA_NATIVE_EVENT_PROXY
            - CLUSTER_TYPE_CLOUD_API_GATEWAY
            - CLUSTER_TYPE_SERVERLESS_V1
        auth_type:
          description: The auth type value of the cluster associated with the Runtime Group.
          type: string
          example: pinned_client_certs
          enum:
            - pinned_client_certs
            - pki_client_certs
        cloud_gateway:
          description: Whether this runtime group can be used for cloud-gateways.
          type: boolean
          example: false
        proxy_urls:
          $ref: "#/components/schemas/ProxyURLs"
        labels:
          $ref: "#/components/schemas/Labels"
      additionalProperties: false
      required:
        - name
      title: CreateRuntimeGroupRequest
```
