---
updatedAt: 2026-06-15T13:51:20.000Z
agentTools:
  siteIndex: https://developer.jamf.com/llms.txt
  projectIndex: https://developer.jamf.com/jamf-pro/llms.txt
---

# Update AD CS Settings configuration


Update AD CS Settings configuration, where certificate information must be provided in full, or not at all. Cannot change between inbound and outbound modes.

> 📋 **Required privilege:** Update AD CS Settings

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Jamf Pro API",
    "termsOfService": "https://www.jamf.com/developer-resources/api-license-agreement",
    "version": "11.32.0"
  },
  "servers": [
    {
      "url": "https://yourServer.jamfcloud.com/api"
    }
  ],
  "x-readme": {
    "samples-languages": [
      "curl",
      "swift",
      "ruby",
      "python"
    ],
    "explorer-enabled": false
  },
  "security": [
    {
      "Bearer": []
    },
    {
      "ApiClient": []
    },
    {
      "BasicAuth": [
        "/v1/auth/token"
      ]
    }
  ],
  "paths": {
    "/v1/pki/adcs-settings/{id}": {
      "patch": {
        "tags": [
          "adcs-settings"
        ],
        "summary": "Update AD CS Settings configuration\n",
        "description": "Update AD CS Settings configuration, where certificate information must be provided in full, or not at all. Cannot change between inbound and outbound modes.\n\n> 📋 **Required privilege:** Update AD CS Settings",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "ID of the AD CS Settings configuration.",
            "required": true,
            "style": "simple",
            "explode": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/merge-patch+json": {
              "schema": {
                "$ref": "#/components/schemas/AdcsSettings"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiError"
                }
              }
            }
          }
        },
        "x-required-privileges": [
          "Update AD CS Settings"
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "AdcsCertificate": {
        "required": [
          "data",
          "filename"
        ],
        "type": "object",
        "properties": {
          "filename": {
            "maxLength": 255,
            "minLength": 1,
            "type": "string",
            "description": "Server certificate filename should extend .cer or .pem, and client certificate filename should extend .p12 or .pfx.",
            "example": "example.cer"
          },
          "data": {
            "type": "array",
            "description": "Must be base-64 encoded data obtainable by `openssl base64 < /file/path/filename.pfx | tr -d '\\n' | pbcopy` in linux terminal, or similar parsing methods.",
            "example": "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",
            "items": {
              "type": "string",
              "format": "byte"
            }
          },
          "password": {
            "maxLength": 255,
            "minLength": 1,
            "type": "string",
            "format": "password",
            "nullable": true,
            "writeOnly": true,
            "example": "password-example"
          }
        }
      },
      "AdcsSettings": {
        "type": "object",
        "properties": {
          "displayName": {
            "maxLength": 255,
            "minLength": 1,
            "type": "string",
            "example": "Example Display Name"
          },
          "caName": {
            "maxLength": 255,
            "minLength": 1,
            "type": "string",
            "example": "EXAMPLE-SUBCA02-CA"
          },
          "fqdn": {
            "maxLength": 255,
            "minLength": 1,
            "type": "string",
            "example": "example-subca02.example.com"
          },
          "adcsUrl": {
            "maxLength": 255,
            "minLength": 1,
            "type": "string",
            "example": "https://<host-name>.example.com"
          },
          "serverCert": {
            "$ref": "#/components/schemas/AdcsCertificate"
          },
          "clientCert": {
            "$ref": "#/components/schemas/AdcsCertificate"
          },
          "revocationEnabled": {
            "type": "boolean",
            "example": true
          },
          "apiClientId": {
            "type": "string",
            "example": "A11B43D6-9ED4-4B29-B726-E2DE747D2410"
          },
          "outbound": {
            "type": "boolean",
            "example": true
          }
        },
        "description": "AD CS Settings object to create, or update with a merge-patch strategy. Certificate data must be provided in full, or not at all for update with merge-patch strategy."
      },
      "ApiError": {
        "type": "object",
        "properties": {
          "httpStatus": {
            "type": "integer",
            "description": "HTTP status of the response",
            "example": 400
          },
          "errors": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ApiErrorCause"
            }
          }
        }
      },
      "ApiErrorCause": {
        "required": [
          "field"
        ],
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "Error-specific code that can be used to identify localization string, etc.",
            "example": "8675309"
          },
          "field": {
            "type": "string",
            "description": "Name of the field that caused the error.",
            "example": "Name"
          },
          "description": {
            "type": "string",
            "description": "A general description of error for troubleshooting/debugging. Generally this text should not be displayed to a user; instead refer to errorCode and it's localized text",
            "example": "I've just picked up a fault in the AE35 unit. It's going to go 100% failure in 72 hours"
          },
          "id": {
            "type": "string",
            "description": "id of object with error. Optional.",
            "nullable": true,
            "example": "3"
          }
        }
      }
    },
    "securitySchemes": {
      "Bearer": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      },
      "BasicAuth": {
        "type": "http",
        "description": "Basic auth is used only for obtaining bearer tokens from the /v1/auth/token endpoint",
        "scheme": "basic"
      },
      "ApiClient": {
        "type": "oauth2",
        "description": "Jamf Pro API Roles and Clients provide a client ID and secret for obtaining access tokens using the OAuth2 client_credentials grant type",
        "flows": {
          "clientCredentials": {
            "tokenUrl": "/api/v1/oauth/token",
            "scopes": {}
          }
        }
      }
    }
  }
}
```