---
updatedAt: 2025-09-14T23:45:54.000Z
agentTools:
  siteIndex: https://developer.jamf.com/llms.txt
  projectIndex: https://developer.jamf.com/jamf-pro/v11.14.0/llms.txt
---

# Updates an existing LDAP server by ID

```xml Sample Request Body
<ldap_server>
	<connection>
		<name>Company Active Directory</name>
		<hostname>company.ad.com</hostname>
		<server_type>Active Directory</server_type>
		<port>389</port>
		<use_ssl>true</use_ssl>
		<authentication_type>simple</authentication_type>
		<certificate_used>Base64EncodedCertificateData</certificate_used>
		<account>
			<distinguished_username>CN=Administrator,CN=Users,DC=Company,DC=com</distinguished_username>
			<password>password</password>
		</account>
		<open_close_timeout>15</open_close_timeout>
		<search_timeout>60</search_timeout>
		<referral_response>ignore</referral_response>
		<use_wildcards>true</use_wildcards>
		<connection_is_used_for>users</connection_is_used_for>
	</connection>
	<mappings_for_users>
		<user_mappings>
			<map_object_class_to_any_or_all>all</map_object_class_to_any_or_all>
			<object_classes>organizationalPerson, user</object_classes>
			<search_base>DC=Company,DC=com</search_base>
			<search_scope>All Subtrees</search_scope>
			<map_user_id>uSNCreated</map_user_id>
			<map_username>sAMAccountName</map_username>
			<map_realname>displayName</map_realname>
			<map_email_address>mail</map_email_address>
			<append_to_email_results>company.com</append_to_email_results>
			<map_department>department</map_department>
			<map_building>streetAddress</map_building>
			<map_room>room</map_room>
			<map_telephone>telephoneNumber</map_telephone>
			<map_position>title</map_position>
			<map_user_uuid>objectGUID</map_user_uuid>
		</user_mappings>
		<user_group_mappings>
			<map_object_class_to_any_or_all>all</map_object_class_to_any_or_all>
			<object_classes>top, group</object_classes>
			<search_base>DC=Company,DC=com</search_base>
			<search_scope>All Subtrees</search_scope>
			<map_group_id>uSNCreated</map_group_id>
			<map_group_name>name</map_group_name>
			<map_group_uuid>objectGUID</map_group_uuid>
		</user_group_mappings>
		<user_group_membership_mappings>
			<user_group_membership_stored_in>user object</user_group_membership_stored_in>
			<map_group_membership_to_user_field>memberOf</map_group_membership_to_user_field>
			<append_to_username>company.com</append_to_username>
			<use_dn>true</use_dn>
			<recursive_lookups>true</recursive_lookups>
			<map_user_membership_to_group_field>true</map_user_membership_to_group_field>
			<map_user_membership_use_dn>true</map_user_membership_use_dn>
			<map_object_class_to_any_or_all>all</map_object_class_to_any_or_all>
			<object_classes>group</object_classes>
			<search_base>DC=Company,DC=com</search_base>
			<search_scope>All Subtrees</search_scope>
			<username>sAMAccountName</username>
			<group_id>uSNCreated</group_id>
			<user_group_membership_use_ldap_compare>true</user_group_membership_use_ldap_compare>
		</user_group_membership_mappings>
	</mappings_for_users>
</ldap_server>
```

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "version": "11.12.0",
    "title": "Classic API",
    "license": {
      "name": "Jamf API License Agreement",
      "url": "https://developer.jamf.com/developer-guide/docs/api-license-agreement"
    }
  },
  "security": [
    {
      "basicAuth": []
    }
  ],
  "x-readme": {
    "samples-languages": [
      "curl",
      "swift",
      "ruby",
      "python"
    ],
    "explorer-enabled": false,
    "proxy-enabled": true
  },
  "paths": {
    "/ldapservers/id/{id}": {
      "put": {
        "x-explorer-enabled": false,
        "tags": [
          "ldapservers"
        ],
        "summary": "Updates an existing LDAP server by ID",
        "operationId": "updateLDAPServerById",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "ID value to filter by",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "201": {
            "description": "Created"
          }
        }
      }
    }
  },
  "x-si-base": "swagger.yaml",
  "x-github-repo": "jamf/Classic-API-Swagger-Specification",
  "x-github-sha": "070fac498a589aaa0958641a68e4065584fc244a",
  "servers": [
    {
      "url": "https://yourServer.jamfcloud.com/JSSResource"
    }
  ],
  "components": {
    "securitySchemes": {
      "basicAuth": {
        "type": "http",
        "scheme": "basic"
      }
    }
  }
}
```