# Custom Quarantine Messages

Configure Repository Firewall to provide a custom quarantine message when a component request fails a Firewall policy. This message and the default Firewall quarantine messages are included in the command line output.

Use cases for the capability:

- Provide instructions on how to respond when components are quarantined during their builds.
- Using up to 500 characters the custom messages may contain a URL pointing to internal instructions
- For Repository Firewall release 165 or greater using Nexus Repository Pro version 3.58 or greater
- For Repository Firewall using JFrog Artifactory plugin 2.4.11 or greater

**Note**  
For SaaS deployments, tenant administrators can configure custom quarantine messages using the REST API. This enables self-service configuration without requiring Sonatype Support.

## Setting the quarantine message

Send a command to the [Configuration REST API](https://help.sonatype.com/en/configuration-rest-api.html "Configuration REST API") to PUT a JSON object containing the quarantine message property.

```
quarantinedItemCustomMessage
```

```
curl -X PUT -u admin:admin123 \
     -H "Content-Type: application/json" \
     -d '{"quarantinedItemCustomMessage": "Custom message http://domain.com/quarantine-guide"}' \
     "http://localhost:8070/api/v2/config"
```

## Getting the current message

Use a GET request to check the value of the property from the config API

```
curl -X GET -u admin:admin123 \
     "http://localhost:8070/api/v2/config?property=quarantinedItemCustomMessage"
```

## Deleting the custom message

Use a DELETE request to remove the message

```
curl -X DELETE -u admin:admin123 \
     "http://localhost:8070/api/v2/config?property=quarantinedItemCustomMessage"
```

## Search results

No results found