---
title: "Update a Certificate"
url: "https://nov18-dev.movespot.fyi/apis/konnect-runtime-groups-configuration-0/versions/af18902c-58f1-49d7-8ec2-9987b4e0d1bd/operations/update-certificate-put"
---

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

# Update a Certificate

`PUT` `/runtime-groups/{runtimeGroupId}/core-entities/certificates/{certificate_id}`

Operation ID: `update-certificate-put`

Update details about the specified certificate using the provided path parameter `certificate_id`. Inserts (or replaces) the certificate under the requested `certificate_id`with the definition specified in the request body. When the `id` attribute has the structure of a UUID, the certificate being inserted/replaced will be identified by its `id`. Otherwise it will be identified by the `name`. When creating a new Certificate without specifying `id` (neither in the path or the request body), then it will be auto-generated.

## Path parameters

- `certificate_id` (string, required) - The unique identifier of the Certificate 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` - Successfully upserted Certificate
- `400` - Invalid Certificate

## 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/certificates/{certificate_id}:
    parameters:
      - name: certificate_id
        in: path
        description: The unique identifier of the Certificate to retrieve.
        required: true
        schema:
          type: string
          example: 7fca84d6-7d37-4a74-a7b0-93e576089a41
      - name: runtimeGroupId
        in: path
        description: The ID of your runtime group. This variable is available in the
          Konnect manager
        required: true
        schema:
          type: string
          example: 9524ec7d-36d9-465d-a8c5-83a3c9390458
    put:
      operationId: update-certificate-put
      summary: Update a Certificate
      description: >
        Update details about the specified certificate using the provided path
        parameter `certificate_id`.


        Inserts (or replaces) the certificate under the requested
        `certificate_id`with the definition specified in the request body. When
        the `id` attribute has the structure of a UUID, the certificate being
        inserted/replaced will be identified by its `id`. Otherwise it will be
        identified by the `name`.


        When creating a new Certificate without specifying `id` (neither in the
        path or the request body), then it will be auto-generated.
      requestBody:
        $ref: "#/components/requestBodies/cert-request"
      responses:
        "200":
          description: Successfully upserted Certificate
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Certificate"
        "400":
          description: Invalid Certificate
          content:
            application/json:
              schema:
                type: object
      tags:
        - Certificates
security:
  - konnectAccessToken: []
  - personalAccessToken: []
components:
  requestBodies:
    cert-request:
      content:
        application/json:
          schema:
            type: object
            properties:
              cert:
                description: "PEM-encoded public certificate chain of the SSL key pair. "
                type: string
                example: -----BEGIN CERTIFICATE-----...,
              key:
                description: "PEM-encoded private key of the SSL key pair. "
                type: string
                example: -----BEGIN RSA PRIVATE KEY-----...
              cert_alt:
                description: "PEM-encoded public certificate chain of the alternate SSL key
                  pair. "
                type: string
              key_alt:
                description: "PEM-encoded private key of the alternate SSL key pair. "
                type: string
                example: -----BEGIN EC PRIVATE KEY-----...
              tags:
                description: >
                  An optional set of strings associated with the Certificate for
                  grouping and filtering.
                type: array
                items:
                  type: string
            required:
              - cert
              - key
            x-examples:
              Example:
                id: 7fca84d6-7d37-4a74-a7b0-93e576089a41
                created_at: 1422386534
                cert: -----BEGIN CERTIFICATE-----...
                key: -----BEGIN RSA PRIVATE KEY-----...
                cert_alt: -----BEGIN CERTIFICATE-----...
                key_alt: -----BEGIN EC PRIVATE KEY-----...
                snis:
                  - foo.test
                  - example.com
                tags:
                  - user-level
                  - low-priority
  schemas:
    Certificate:
      description: A certificate object represents a public certificate. These fields
        are _referenceable_, and can be stored as
        [secrets](http://docs.konqhq.com/gateway/latest/plan-and-deploy/security/secrets-management/getting-started)
        in a vault. References must follow a [specific
        format](/gateway/latest/plan-and-deploy/security/secrets-management/reference-format).
      type: object
      properties:
        cert:
          description: PEM-encoded public certificate chain of the SSL key This field is
            referenceable and can be stored in a vault. References must follow a
            [specific
            format](/gateway/latest/plan-and-deploy/security/secrets-management/reference-format).
          type: string
          example: -----BEGIN CERTIFICATE-----\ncertificate-content\n-----END
            CERTIFICATE-----
        cert_alt:
          description: PEM-encoded public certificate chain of the alternate SSL key pair.
            This should only be set if you have both RSA and ECDSA types of
            certificate available and would like Kong to prefer serving using
            ECDSA certs.
          type: string
          example: -----BEGIN CERTIFICATE-----...
        created_at:
          description: Unix epoch when the resource was created.
          type: integer
          example: 1422386534
        updated_at:
          description: Unix epoch when the resouce was updated.
          type: integer
          example: 1422386534
        id:
          description: The UUID representation of the certificate object.
          type: string
          format: uuid
          example: 7fca84d6-7d37-4a74-a7b0-93e576089a41
        key:
          description: PEM-encoded private key of the SSL key pair. This field is
            _referenceable_, which means it can be securely stored as a
            [secret](/gateway/latest/plan-and-deploy/security/secrets-management/getting-started)
            in a vault. References must follow a [specific
            format](/gateway/latest/plan-and-deploy/security/secrets-management/reference-format).
          type: string
          example: " -----BEGIN RSA PRIVATE KEY-----..."
        key_alt:
          description: PEM-encoded private key of the alternate SSL key pair. This should
            only be set if you have both RSA and ECDSA types of certificate
            available and would like Kong to prefer serving using ECDSA certs
            when client advertises support for it. This field is
            _referenceable_, which means it can be securely stored as a
            [secret](/gateway/latest/plan-and-deploy/security/secrets-management/getting-started)
            in a vault. References must follow a [specific
            format](/gateway/latest/plan-and-deploy/security/secrets-management/reference-format).
          type: string
          example: -----BEGIN EC PRIVATE KEY-----...
        tags:
          description: An optional set of strings associated with the Certificate for
            grouping and filtering.
          type: array
          items:
            type: string
            example: user-level
      example:
        cert: |-
          -----BEGIN CERTIFICATE-----
          certificate-content
          -----END CERTIFICATE-----
        id: b2f34145-0343-41a4-9602-4c69dec2f269
        key: |-
          -----BEGIN PRIVATE KEY-----
          private-key-content
          -----END PRIVATE KEY-----
      title: Certificate
  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.
```
