---
title: "Upsert connector configuration"
method: PUT
path: "/v1/kafka-connect/clusters/{cluster_name}/connectors/{name}/config"
tags: ["Kafka Connect"]
---

# Upsert connector configuration

`PUT /v1/kafka-connect/clusters/{cluster_name}/connectors/{name}/config`

## Request

- Base URL: `https://{dataplane_api_url}`
- URL: `https://{dataplane_api_url}/v1/kafka-connect/clusters/{cluster_name}/connectors/{name}/config`
- Auth: OAuth 2
  - Implicit: `https://auth.prd.cloud.redpanda.com/oauth/authorize`

Update the configuration for an existing connector with the specified name, or create a new connector using the given configuration. Returns information about the connector after the change has been made.

## Path parameters

- `cluster_name` string, required
- `name` string, required

## Request body

- object

## Response `200`

Updated

- ConnectorSpec: Connector specifications as defined in the Kafka Connect API. You may include this in the request body when creating a new connector.
  - `config` object, required: Connector configuration properties.
  - `name` string, required: Name of connector.
  - `tasks` TaskInfo[]
    - `connector` string: Name of connector.
    - `task` integer: The connector task ID.
  - `type` string

## Other responses

- `201`: Created
- `401`: Unauthenticated.
- `500`: Internal Server Error. Reach out to support.
- `default`: An unexpected error response.

## Changes

- **2025-03-18** `d8ef59d98e13`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/redpanda-data/apis/redpanda-cloud-data-plane-api/changes/v1/kafka-connect/clusters/:cluster_name/connectors/:name/config/put.md)

---

[API](https://skmtc.dev/redpanda-data/apis/redpanda-cloud-data-plane-api.md) - [All operations](https://skmtc.dev/redpanda-data/apis/redpanda-cloud-data-plane-api/llms.txt) - [OpenAPI document](https://skmtc.dev/redpanda-data/apis/redpanda-cloud-data-plane-api/revisions/ff1b476fd533?raw)