Skip to main content
PATCH
Update Signal Agent
The signal type is immutable — it cannot be changed after creation. When you send filters, they replace the existing ones and are validated against the agent’s signal type.Use activate to change the run status: activate: false pauses the agent immediately, activate: true reactivates a paused one (which re-runs billing and external watcher setup). A draft cannot be toggled this way — activate a draft through Create Signal Agent instead. Omit activate to leave the status unchanged.

Authorizations

Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json
watchListId
string
required

Signal Agent id to update

name
string

New display name

filters
object[]

Replacement filters (validated against the agent's signal type)

emoji
string

New emoji

signalProcessingType
enum<string>

New signal processing type

Available options:
manual,
create_opportunity,
push_to_campaign
personaId
string

Persona (pdp_xxx) used to source contacts from the People Database. Only for a company Signal Agent with signalProcessingType = push_to_campaign whose signal type does not already ship its own contact. Optional; rejected on any other configuration.

activate
boolean

Toggle the agent status. false deactivates (pauses) it immediately. true reactivates a paused agent (triggers billing and external watcher setup). A draft cannot be toggled this way. Omit to leave the status unchanged.

Response

Success

data
object

A Signal Agent (watch list) configuration.