Deals

Stop showing a deal to a classification

DELETE/deals/{id}/classifications/{member_id}
deal-visibility:writeremove_deal_classificationsDestructiveIdempotent

Removes the classification from the set and returns 204, also when it was not there, so a retry is safe. It deletes only the show rule, never an exclusion of the same class, and never takes back folder access already granted. Same 409 rule as adding, but only when it would remove something: removing a class that is not there returns 204 on a deal in any status. No dry run. Emits deal.updated with classifications in changed_fields; no email. The POST undoes it.

Path parameters

  • idstring (uuid)Required#

    The record's id.

  • member_idintegerRequired#

    The classification to remove.

Responses

204

The deal is no longer shown to the classification through this set.

401

Authentication failed. error.code is one of invalid_token, expired, revoked.

Error
403

Authorization failed. error.code is one of org_disabled, ip_blocked, missing_scope, scope_disabled, user_disabled.

Error
404

Resource not found (error.code = not_found).

Error
409

The request conflicts with existing state (error.code = conflict), e.g. a compliance flow with the requested name already exists.

Error
422

The request can't be processed (HTTP 422): validation_failed with one ErrorDetail per problem, or a code documented on the operation.

Error
429

Rate limit exceeded (error.code = rate_limited).

Error

Examples

curl -X DELETE https://your-org-domain/kong/core/api/v2/deals/{id}/classifications/{member_id}\
  -H "Authorization: Bearer $HELM_API_KEY"\
  -H "Content-Type: application/json"