Deletes a referral submission by id. The referralId is the id returned by referral.list.

The optional clearAttribution field controls whether attribution is also removed from the associated application:

• None is the default and deletes only the referral.
• CreditedToUser clears the credited user. This is recommended when the employee should no longer see the candidate in their personal Referral dashboard because it preserves Referral as the source for org-level sourcing analytics.
• Source clears the source.
• All clears both the credited user and source.

Attribution is cleared only when it still belongs to the referral. The credited user must still be the referral's referrer. The source must still be the built-in source for the referral type, which is Referral for direct referrals and Referral Link for social referrals. The response flags report which requested fields were actually cleared.

The associated application is not deleted. Restoring the referral within the 7-day restoration window restores only the referral row and does not restore cleared attribution. Returns referral_not_found when the referral does not exist or is not visible to the acting user.

Requires the candidatesDelete permission.