---
title: "Update an SNI"
url: "https://nov18-dev.movespot.fyi/apis/konnect-runtime-groups-configuration-0/versions/af18902c-58f1-49d7-8ec2-9987b4e0d1bd/operations/upsert-sni"
---

> Full API specification: https://nov18-dev.movespot.fyi/apis/konnect-runtime-groups-configuration-0/versions/af18902c-58f1-49d7-8ec2-9987b4e0d1bd.md

# Update an SNI

`PUT` `/runtime-groups/{runtimeGroupId}/core-entities/snis/{sni_id}`

Operation ID: `upsert-sni`

Create or Update SNI using ID or name.

## Path parameters

- `sni_id` (string, required) - The unique identifier or the name of the SNI to retrieve.
- `runtimeGroupId` (string, required) - The ID of your runtime group. This variable is available in the Konnect manager

## Request body

Content types: `application/json`

## Responses

- `200` - SNI response object
- `400` - Invalid SNI

## OpenAPI definition

```yaml
openapi: 3.0.0
info:
  title: Konnect Runtime Groups Configuration
  version: 0.0.1
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
paths:
  /runtime-groups/{runtimeGroupId}/core-entities/snis/{sni_id}:
    parameters:
      - $ref: "#/components/parameters/sni_id"
      - $ref: "#/components/parameters/runtimeGroupId"
    put:
      operationId: upsert-sni
      summary: Update an SNI
      description: Create or Update SNI using ID or name.
      requestBody:
        $ref: "#/components/requestBodies/create-sni"
      responses:
        "200":
          $ref: "#/components/responses/sni-response"
        "400":
          description: Invalid SNI
          content:
            application/json:
              schema:
                type: object
      tags:
        - SNIs
security:
  - konnectAccessToken: []
  - personalAccessToken: []
components:
  parameters:
    sni_id:
      name: sni_id
      in: path
      required: true
      schema:
        type: string
        example: my-sni
      description: The unique identifier or the name of the SNI to retrieve.
    runtimeGroupId:
      name: runtimeGroupId
      in: path
      required: true
      schema:
        type: string
        example: 9524ec7d-36d9-465d-a8c5-83a3c9390458
      description: The ID of your runtime group. This variable is available in the
        Konnect manager
  requestBodies:
    create-sni:
      content:
        application/json:
          schema:
            type: object
            properties:
              name:
                description: The SNI name to associate with the given certificate.
                type: string
                example: my-sni
              tags:
                description: >
                  An optional set of strings associated with the SNIs for
                  grouping and filtering.
                type: array
                items:
                  type: string
                  example: "[user-level, low-priority]"
              certificate:
                description: The id (a UUID) of the certificate with which to associate the SNI
                  hostname. The Certificate must have a valid private key
                  associated with it to be used by the SNI object. With
                  form-encoded, the notation is `certificate.id=<certificate
                  id>`. With JSON, use `“certificate:{id:<certificate id>”}`.
                type: object
                properties:
                  id:
                    description: 91020192-062d-416f-a275-9addeeaffaf2
                    type: string
                    example: 91020192-062d-416f-a275-9addeeaffaf2
                required:
                  - id
            required:
              - name
              - certificate
            x-examples:
              Example 1:
                name: my-sni
                tags:
                  - user-level
                  - low-priority
                certificate:
                  id: a2e013e8-7623-4494-a347-6d29108ff68b
      description: A JSON object containing the details of the new SNI, including the
        name, certificate, and tags.
  responses:
    sni-response:
      description: SNI response object
      content:
        application/json:
          schema:
            type: object
            properties:
              data:
                description: Array of SNIs
                type: array
                items:
                  type: object
                  properties:
                    id:
                      description: The unique identifier or the name attribute of the Certificate
                        whose SNIs are to be retrieved. When using this
                        endpoint, only SNIs associated to the specified
                        Certificate will be listed.
                      type: string
                      example: 147f5ef0-1ed6-4711-b77f-489262f8bff7
                    name:
                      description: |
                        The SNI name to associate with the given certificate.
                      type: string
                      example: my-sni
                    created_at:
                      description: |
                        Unix epoch when the resource was created.
                      type: integer
                      example: 1422386534
                    tags:
                      description: >
                        An optional set of strings associated with the SNIs for
                        grouping and filtering.
                      type: array
                      items:
                        type: string
                    certificate:
                      description: >
                        The id (a UUID) of the certificate with which to
                        associate the SNI hostname. The Certificate must have a
                        valid private key associated with it to be used by the
                        SNI object.
                      type: object
                      properties:
                        id:
                          description: The unique identifier or the name attribute of the Certificate
                            whose SNIs
                          type: string
                          example: 2e013e8-7623-4494-a347-6d29108ff68b
              next:
                description: Offset is used to paginate through the API. Provide this value to
                  the next list operation to fetch the next page
                type: string
                example: http://localhost:8001/snis?offset=6378122c-a0a1-438d-a5c6-efabae9fb969
            x-examples:
              Example 1:
                data:
                  - id: 147f5ef0-1ed6-4711-b77f-489262f8bff7
                    name: my-sni
                    created_at: 1422386534
                    tags:
                      - user-level
                      - low-priority
                    certificate:
                      id: a3ad71a8-6685-4b03-a101-980a953544f6
                  - id: b87eb55d-69a1-41d2-8653-8d706eecefc0
                    name: my-sni
                    created_at: 1422386534
                    tags:
                      - admin
                      - high-priority
                      - critical
                    certificate:
                      id: 4e8d95d4-40f2-4818-adcb-30e00c349618
                next: http://localhost:8001/snis?offset=6378122c-a0a1-438d-a5c6-efabae9fb969
          examples:
            Example SNI response:
              value:
                certificate:
                  id: e94215b0-9198-42ce-bf0b-98afff31b2a7
                created_at: 1685646239
                id: cf3b640e-100e-4fa4-aef6-2dc0488d7a58
                name: my-sni
                updated_at: 1685646239
  securitySchemes:
    konnectAccessToken:
      type: http
      scheme: bearer
      description: >-
        The Konnect access token is meant to be used by the Konnect dashboard
        and the decK CLI to

        authenticate with.
    personalAccessToken:
      type: http
      scheme: bearer
      description: The personal access token is meant to be used as an alternative to
        basic-auth when accessing Konnect via APIs. You can generate a Personal
        Access Token (PAT) from the personal access token page in the Konnect
        dashboard.
```
