---
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`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/product-analytics/{entity}/mapping/connection`
- Auth: one of:
  - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`
  - OAuth 2
    - Authorization code: `/oauth2/v1/authorize`
    - Token URL: `/oauth2/v1/token`

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/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)