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

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

# Update a CA Certificate

`PUT` `/runtime-groups/{runtimeGroupId}/core-entities/ca_certificates/{ca_certificate_id}`

Operation ID: `updatet-ca_certificate`

Create or Update a CA Certificate using the provided path parameter `ca_certificate_id`.

## Path parameters

- `ca_certificate_id` (string, required) - ID of the related certificate
- `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 CA Certificate
- `400` - Invalid CA 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/ca_certificates/{ca_certificate_id}:
    parameters:
      - $ref: "#/components/parameters/ca_certificate_id"
      - $ref: "#/components/parameters/runtimeGroupId"
    put:
      operationId: updatet-ca_certificate
      summary: Update a CA Certificate
      description: Create or Update a CA Certificate using the provided path parameter
        `ca_certificate_id`.
      requestBody:
        $ref: "#/components/requestBodies/CA-cert-request"
      responses:
        "200":
          description: Successfully upserted CA Certificate
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/CA-Certificate"
        "400":
          description: Invalid CA Certificate
          content:
            application/json:
              schema:
                type: object
      tags:
        - CA Certificates
security:
  - konnectAccessToken: []
  - personalAccessToken: []
components:
  parameters:
    ca_certificate_id:
      name: ca_certificate_id
      description: ID of the related certificate
      in: path
      required: true
      schema:
        type: string
        example: 7fca84d6-7d37-4a74-a7b0-93e576089a41
    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:
    CA-cert-request:
      content:
        application/json:
          schema:
            type: object
            properties:
              cert:
                description: |
                  PEM-encoded public certificate of the CA.
                type: string
                example: -----BEGIN CERTIFICATE-----...
              cert_digest:
                description: |
                  SHA256 hex digest of the public certificate.
                type: string
                example: c641e28d77e93544f2fa87b2cf3f3d51...
              tags:
                description: An optional set of strings associated with the Certificate for
                  grouping and filtering.
                type: array
                items:
                  type: string
            required:
              - cert
            x-examples:
              Example 1:
                cert: -----BEGIN CERTIFICATE-----...
                cert_digest: c641e28d77e93544f2fa87b2cf3f3d51...
                tags:
                  - user-level
                  - low-priority
      description: This request body represents a new Certificate Authority (CA)
        certificate and includes the properties required to create a new
        certificate.
  schemas:
    CA-Certificate:
      description: A CA certificate object represents a trusted CA. These objects are
        used by Kong to verify the validity of a client or server certificate.
        CA Certificates can be both tagged and filtered by tags.
      type: object
      properties:
        cert:
          description: PEM-encoded public certificate of the CA.
          type: string
          example: -----BEGIN CERTIFICATE-----...
        cert_digest:
          description: SHA256 hex digest of the public certificate.
          type: string
          example: c641e28d77e93544f2fa87b2cf3f3d51...
        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:
          type: string
          format: uuid
          example: 04fbeacf-a9f1-4a5d-ae4a-b0407445db3f
        tags:
          description: An optional set of strings associated with the Certificate for
            grouping and filtering.
          type: array
          items:
            type: string
            example: "[user-level, low-priority]"
      example:
        cert: |-
          -----BEGIN CERTIFICATE-----
          certificate-content
          -----END CERTIFICATE-----
        id: b2f34145-0343-41a4-9602-4c69dec2f260
      title: CA-Certificate
      x-examples:
        200 - list of multiple certificates:
          data:
            - id: 43429efd-b3a5-4048-94cb-5cc4029909bb
              created_at: 1422386534
              updated_at: 1422386534
              cert: -----BEGIN CERTIFICATE-----...
              cert_digest: c641e28d77e93544f2fa87b2cf3f3d51...
              tags:
                - user-level
                - low-priority
            - id: d26761d5-83a4-4f24-ac6c-cff276f2b79c
              created_at: 1422386534
              updated_at: 1422386534
              cert: -----BEGIN CERTIFICATE-----...
              cert_digest: c641e28d77e93544f2fa87b2cf3f3d51...
              tags:
                - admin
                - high-priority
                - critical
          next: http://localhost:8001/ca_certificates?offset=6378122c-a0a1-438d-a5c6-efabae9fb969
  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.
```
