---
title: "Update connection"
method: PUT
path: "/api/v2/product-analytics/{entity}/mapping/connection"
tags: ["Rum Audience Management"]
---

# Update connection

`PUT /api/v2/product-analytics/{entity}/mapping/connection`

Update an existing data connection by adding, updating, or deleting fields

## Path parameters

- `entity` string, required

## Request body

- UpdateConnectionRequest — Request body for updating an existing data source connection by adding, modifying, or removing fields.
  - `data` UpdateConnectionRequestData — The data object containing the resource identifier and attributes for updating an existing connection.
    - `attributes` UpdateConnectionRequestDataAttributes — Attributes specifying the field modifications to apply to an existing connection.
      - `fields_to_add` CreateConnectionRequestDataAttributesFieldsItems[] — New fields to add to the connection from the data source.
        - `description` string — Human-readable explanation of what the field represents.
        - `display_name` string — The human-readable label for the field shown in the UI.
        - `groups` string[] — List of group labels used to categorize the field.
        - `id` string, required — The unique identifier for the field within the connection.
        - `source_name` string, required — The name of the column or attribute in the source data system that maps to this field.
        - `type` string, required — The data type of the field (for example, string or number).
      - `fields_to_delete` string[] — Identifiers of existing fields to remove from the connection.
      - `fields_to_update` UpdateConnectionRequestDataAttributesFieldsToUpdateItems[] — Existing fields with updated metadata to apply to the connection.
        - `field_id` string, required — The identifier of the existing field to update.
        - `updated_description` string — The new description to set for the field.
        - `updated_display_name` string — The new human-readable display name to set for the field.
        - `updated_field_id` string — The new identifier to assign to the field, if renaming it.
        - `updated_groups` string[] — The updated list of group labels to associate with the field.
    - `id` string, required — The unique identifier of the connection to update.
    - `type` 'connection_id', required — Connection id resource type.

## Response `200`

Connection updated successfully

## Other responses

- `429` — Too many requests

---

[API](https://skmtc.dev/datadog/apis/api-v2.md) · [All operations](https://skmtc.dev/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/datadog/api-v2/revisions/da68bf029e4c/schema)