---
title: Update a Configuration
framework: Apple Business API
role: symbol
role_heading: Web Service Endpoint
platforms: [apple business api 2.5+]
path: applebusinessapi/update-a-configuration
---

# Update a Configuration

Update an existing custom Configuration in an organization.

## URL

PATCH https://api-business.apple.com/v1/configurations/{id}

## Path Parameters

id: The unique identifier for the resource.

## Response Codes

200 OK: 400 Bad Request: An error occurred with your request. 401 Unauthorized: 403 Forbidden: Request not authorized. 404 Not Found: 409 Conflict: Request entity error(s). 422 : Unprocessable request entity error(s). 429 : Too Many Requests

## Overview

Overview important: Only Configurations with type CUSTOM_SETTING can be updated via the API. note: If a filename is provided, it must end in .mobileconfig. A provided configurationProfile is validated and must be compatible with the resolved configuredForPlatforms (either from the request or the existing value on the Configuration). note: Only the fields included in the request are updated. One of name, configuredForPlatforms, configurationProfile, or filename must be included, and any omitted fields retain their existing values. Example

## Topics

### Responses

- [ConfigurationResponse](applebusinessapi/configurationresponse.md)

## See Also

### Configurations

- [Get Configurations](applebusinessapi/get-configurations.md)
- [Create a Configuration](applebusinessapi/create-a-configuration.md)
- [Get Configuration Information](applebusinessapi/get-configuration-information.md)
- [Delete a Configuration](applebusinessapi/delete-a-configuration.md)