---
title: "Pin New DP Client Certificate"
url: "https://nov18-dev.movespot.fyi/apis/konnect-runtime-groups-configuration-0/versions/af18902c-58f1-49d7-8ec2-9987b4e0d1bd/operations/post-dp-client-certificates"
---

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

# Pin New DP Client Certificate

`POST` `/runtime-groups/{runtimeGroupId}/dp-client-certificates`

Operation ID: `post-dp-client-certificates`

Pin a new DP Client Certificate to this runtime group. A pinned dataplane certificate allows dataplanes configured with the certificate and corresponding private key to establish connection with this runtime group.

## Path parameters

- `runtimeGroupId` (string, required) - The ID of your runtime group. This variable is available in the Konnect manager

## Request body

Content types: `application/json`

## Responses

- `201` - Response body for retrieving a dp-client-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}/dp-client-certificates:
    parameters:
      - $ref: "#/components/parameters/runtimeGroupId"
    post:
      operationId: post-dp-client-certificates
      summary: Pin New DP Client Certificate
      description: Pin a new DP Client Certificate to this runtime group. A pinned
        dataplane certificate allows dataplanes configured with the certificate
        and corresponding private key to establish connection with this runtime
        group.
      requestBody:
        $ref: "#/components/requestBodies/create-dp-client-cert"
      responses:
        "201":
          $ref: "#/components/responses/get-dp-client-cert"
      tags:
        - DP Certificates
security:
  - konnectAccessToken: []
  - personalAccessToken: []
components:
  parameters:
    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-dp-client-cert:
      content:
        application/json:
          schema:
            type: object
            properties:
              cert:
                description: JSON escaped string of the certificate.
                type: string
            required:
              - cert
          examples:
            Sample DP Client Certificate:
              value:
                cert: "-----BEGIN CERTIFICATE-----\r

                  *****\r

                  -----END CERTIFICATE-----\r\n"
      description: Request body for creating a dp-client-certificate.
  responses:
    get-dp-client-cert:
      description: Response body for retrieving a dp-client-certificate.
      content:
        application/json:
          schema:
            type: object
            properties:
              item:
                type: object
                properties:
                  id:
                    description: Unique ID of the certificate entity.
                    type: string
                  created_at:
                    description: Date certificate was created.
                    type: integer
                  updated_at:
                    description: Date certificate was last updated.
                    type: integer
                  cert:
                    description: JSON escaped string of the certificate.
                    type: string
  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.
```
