---
title: Delete Default Message
framework: retentionmessaging
role: symbol
role_heading: Web Service Endpoint
path: retentionmessaging/delete-default-message
---

# Delete Default Message

Deletes a default message for a product in a locale.

## URL

DELETE https://api.storekit.apple.com/inApps/v1/messaging/default/{productId}/{locale}

## Sandbox URL

DELETE https://api.storekit-sandbox.apple.com/inApps/v1/messaging/default/{productId}/{locale}

## Path Parameters

locale: The locale of the default message configuration. productId: The product ID of the default message configuration.

## Response Codes

200 OK: Request succeeded. 400 Bad Request: The request is invalid and unacceptable. 401 Unauthorized: The JSON Web Token (JWT) in the authorization header is invalid. For more information, see Generating JSON Web Tokens for API requests. 429 : The request exceeded the rate limit. For more information, see Identifying rate limits. 500 Internal Server Error: Server error. Try again later.

## Mentioned in

Identifying rate limits

## Discussion

Discussion Call this endpoint to delete a default message configuration. After a successful deletion, productId in locale has no default message. This endpoint is idempotent. If the product has no configured default message for the locale, the endpoint still responds with a 200 status code.

## See Also

### Default message configuration

- [Configure Default Message](retentionmessaging/configure-default-message.md)
- [Get Default Message](retentionmessaging/get-default-message.md)
- [DefaultConfigurationRequest](retentionmessaging/defaultconfigurationrequest.md)
- [DefaultConfigurationResponse](retentionmessaging/defaultconfigurationresponse.md)