---
title: Modify merchant ids
framework: appstoreconnectapi
role: symbol
role_heading: Web Service Endpoint
path: appstoreconnectapi/patch-v1-merchantids-_id_
---

# Modify merchant ids

Update a specific merchant ID.

## URL

PATCH https://api.appstoreconnect.apple.com/v1/merchantIds/{id}

## Path Parameters

id: An opaque resource ID that uniquely identifies the resource. Obtain the merchant ID resource ID from the List merchant ids response.

## Response Codes

200 OK: 400 Bad Request: 401 Unauthorized: 403 Forbidden: 404 Not Found: 409 Conflict: 422 : 429 :

## See Also

### Managing merchant IDs

- [Managing merchant IDs and Payment Processing certificates](appstoreconnectapi/managing-payment-processing-certificates.md)
- [List merchant ids](appstoreconnectapi/get-v1-merchantids.md)
- [Read details for a merchant id](appstoreconnectapi/get-v1-merchantids-_id_.md)
- [List certificates for a merchant id](appstoreconnectapi/get-v1-merchantids-_id_-certificates.md)
- [List certificate IDs for a merchant ID](appstoreconnectapi/get-v1-merchantids-_id_-relationships-certificates.md)
- [Create a merchant id](appstoreconnectapi/post-v1-merchantids.md)
- [Delete a merchant id](appstoreconnectapi/delete-v1-merchantids-_id_.md)