---
title: "Update Existing Destination"
method: PUT
path: "/destinations/{destination_id}"
tags: ["Destinations"]
---

# Update Existing Destination

`PUT /destinations/{destination_id}`

Update an existing destination connector.

The `config` object contains connector-specific properties using **dot notation**.

Use the **GET /destinations/connectors** endpoint with a `connector_code` query parameter to
retrieve the full configuration schema for a specific connector type.

## Path parameters

- `destination_id` string, nullable, required

## Query parameters

- `secret_returned` boolean — Whether to include secret values in the response
- `wait` boolean — When False, save config and return immediately without waiting for KC update

## Request body

- UpdateDestinationReq — Request body for updating an existing destination connector.
  - `name` string, required — Display name for the destination connector.
  - `connector` string, required — Connector type identifier (e.g., 'snowflake', 'bigquery', 'clickhouse', 'postgresql', 's3').
  - `config` object, required — Connector-specific configuration properties using dot notation. Use the GET /destinations/connectors endpoint with a connector_code query parameter to retrieve the full configuration schema for a specific connector type.
  - `kc_cluster_id` string, nullable — KC cluster to deploy this connector to. Omit for default cluster.
  - `tags` string[], nullable — List of tag IDs to assign to this destination

## Response `200`

Successful Response

- DestinationConnector — Destination connector configuration and status.
  - `name` string, nullable — User-defined connector name
  - `connector` string, nullable — Connector type (e.g., 'snowflake', 'bigquery', 'clickhouse')
  - `id` string, nullable — Unique identifier
  - `connector_display_name` string, nullable — Human-readable connector type name
  - `created_timestamp` union — Creation timestamp (ISO 8601)
    - string
    - string, date-time
  - `sub_id` string, nullable — Subscription identifier
  - `tenant_id` string, nullable — Tenant identifier for multi-tenancy
  - `config` object, nullable — Connector configuration parameters
  - `topic_ids` union[], nullable — List of associated topic identifiers
    - union
      - string
      - integer
  - `topic_map` object, nullable — Mapping of topics to their partitions or related entities
  - `topics` union[], nullable — List of topic names
    - union
      - string
      - integer
  - `tasks` integer[], nullable — List of task identifiers
  - `connector_status` string, nullable — Current status: Active, Paused, Stopped, Broken, Starting, Unassigned, Unknown, Pending
  - `desired_state` string, nullable — Desired state: Pending, Active, Paused, Stopped
  - `kc_cluster_id` string, nullable — KC cluster this connector is deployed to. None means default cluster.
  - `task_statuses` object, nullable — Status information for each connector task
  - `tags` string[], nullable — List of tag IDs assigned to this destination

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/streamkap/apis/streamkap-rest-api.md) · [All operations](https://skmtc.net/streamkap/apis/streamkap-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/streamkap/streamkap-rest-api/versions/8aea6143d003/schema)