---
title: "Update ACME restrictions"
source_url: https://dev.digicert.com/certcentral-apis/services-api/api-keys/update-acme-restrictions.html
api_method: PATCH
api_endpoint: "/services/v2/key/{{key_id}}/restrictions"
api_url: "https://www.digicert.com/services/v2/key/{{key_id}}/restrictions"
---

**PATCH** `https://www.digicert.com/services/v2/key/{{key_id}}/restrictions`

Use this endpoint to update the allowed SANs and order-count restriction for an existing ACME key and its associated ACME Directory URL.

## Example requests and responses

**cURL (with restrictions)**

```bash
curl -X PATCH \
  'https://www.digicert.com/services/v2/key/{{key_id}}/restrictions' \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}' \
  -d '{
    "allowed_order_count": 3,
    "sans": [
      "somedomain.com"
    ]
  }'
```

**cURL (without restrictions)**

```bash
curl -X PATCH \
  'https://www.digicert.com/services/v2/key/{{key_id}}/restrictions' \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}' \
  -d '{
    "sans": []
  }'
```


## 204 No Content

```json
// empty
```

## URL path parameters

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Req/Opt</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>key_id</td>
<td>required</td>
<td>int</td>
<td>ID of the ACME key to update.</td>
</tr>
</tbody>
</table>

## Request parameters

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Req/Opt</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>sans</td>
<td>optional</td>
<td>array[string]</td>
<td>Specify the domains (subject alternative names (SANs)) and wildcards allowed for certificates issued with this ACME key. Submit an empty array <code>[]</code> to remove all SAN restrictions. If omitted, the current SAN restrictions remain unchanged. 
<br>Maximum: 250 SANs per ACME Directory URL.</td>
</tr>
<tr>
<td>allowed_order_count</td>
<td>optional</td>
<td>int</td>
<td>Specify the maximum number of certificate orders that can be created with this ACME key. The value cannot be lower than the current <code>used_order_count</code>.</td>
</tr>
</tbody>
</table>