Skip to main content
POST
Delete Signal

Delete Signal

Permanently delete a signal monitor. This removes the job and all associated data from the database and cannot be undone.
This action is irreversible. All configuration and tracked data for the signal will be permanently removed. If you want to stop monitoring temporarily and resume later, use /signal/update with action: "pause" instead.

Request

string
required
The type of signal to delete. Accepted values:
  • job_change
  • new_post
  • person_activity
  • keyword_engagement
  • industry_engagement
  • company_engagement
  • person_engagement
string
The ID of the signal to delete, from /signal/create or /signal/list.
  • Any type, signal_id given: deletes that one signal.
  • Engagement types, omitted: deletes all signals of that signal_type for your account.
  • job_change / new_post / person_activity, omitted: deletes your only signal of that type. If you have several, the request returns 400 and nothing is deleted; pass signal_id.

Response

string
Confirmation that the signal was permanently deleted.
integer
Always 0.

Notes

  • Returns 404 if the signal does not exist or does not belong to your account.
  • For engagement types, omitting signal_id deletes every signal of that type for your account in one call. For profile types it deletes only when you have exactly one.
  • To pause instead of delete, use /signal/update with action: "pause".