---
title: "Update a Redis Software LDAP mapping"
method: PUT
path: "/v1/ldap_mappings/{uid}"
tags: ["LDAP Mapping"]
---

# Update a Redis Software LDAP mapping

`PUT /v1/ldap_mappings/{uid}`

Update an existing LDAP mapping by unique ID.

## Path parameters

- `uid` integer, required

## Request body

- LdapMappingUpdateRequest — Common LDAP mapping properties shared across LDAP mapping payloads.
  - `account_id` integer — SM account ID.
  - `bdbs_email_alerts` string[] — UIDs of databases that LDAP mapping users will receive alerts for.
  - `cluster_email_alerts` boolean — Activate cluster email alerts for an LDAP mapping.
  - `dn` string — LDAP group's distinguished name.
  - `email` string — LDAP mapping's email.
  - `email_alerts` boolean — Activate email alerts for an LDAP mapping.
  - `name` string — LDAP mapping's name.
  - `role_uids` integer[] — List of role uids associated with the LDAP mapping.

## Response `200`

LDAP mapping updated successfully.

- LdapMapping — An API object that represents a Redis Software LDAP mapping.
  - `account_id` integer — SM account ID.
  - `bdbs_email_alerts` string[] — UIDs of databases that LDAP mapping users will receive alerts for.
  - `cluster_email_alerts` boolean — Activate cluster email alerts for an LDAP mapping.
  - `dn` string, required — LDAP group's distinguished name.
  - `email` string, required — LDAP mapping's email.
  - `email_alerts` boolean, required — Activate email alerts for an LDAP mapping.
  - `name` string, required — LDAP mapping's name.
  - `role_uids` integer[], required — List of role uids associated with the LDAP mapping.
  - `action_uid` string — Action uid. If exists - progress can be tracked by the GET /actions/<uid> API.
  - `uid` integer, required — LDAP mapping's unique uid.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict

## Changes

- **2026-06-01** `e0f62447705b` — 1 info
  - endpoint added
- **2026-01-23** `9fdf3bc7ad77` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/redis/apis/redis-software-rest-api/changes/v1/ldap_mappings/:uid/put.md)

---

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