Switch managed cleanup on or off for one relation type

put

https://api.test.bluestonepim.com/rules-engine/relations/{relationId}/settings

Switches managed cleanup on or off. Sending the same value again is a 200, not an error. This does not start a run - the next weekly run picks the change up. A history event is written only when the value changes; sending the same value again writes none. Requires write permission.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Responses

Language

Credentials

OAuth2

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200OK. The saved setting.

400Bad Request. removeProductsFromRelation is missing, or is not true or false (only the JSON booleans are accepted; 1, 0 and "true" are rejected). Or the body is missing, is not valid JSON, or is not a JSON object.

403Forbidden. Nothing was saved. The value is true and managed cleanup is not enabled for this organization. Sending false is always allowed. A caller with no write permission also gets 403, with a different message.

404Not Found. PIM does not know this relation type, or the id is not a PIM relation id (24 hex characters).

500Internal Server Error. The activeRuleCount read failed (nothing was saved), or the write failed. Sending the same request again is safe.

502Bad Gateway. PIM could not be reached, so the relation could not be checked. API Gateway sends this body. The switch value is unknown, not off - retry.