Update a source agent
Update a source agent by ID. Only the fields sent are changed. variables replaces the whole signal list: to add or edit one signal, send the full list returned by GET /v1/agent/{id} with your change applied. Signal values follow the same per-type formats as POST /v1/agent.
Authorizations
API key from Settings → API. Send it as Authorization: Bearer .
Headers
ID of an organization member to act on behalf of. The API key user must be the owner of the organization and the target user must belong to the same organization.
Path Parameters
Body
Name of the agent
Target job titles to search for
Target industries to search in
Target company sizes
Target locations to search in
Target company types
Additional search criteria or instructions
200Type of agent, only "autopilot" is accepted
autopilot The agent's signals. Replaces the whole list: send every signal to keep, not only new or changed ones. Between 4 and 15 variables, with the same per-type value formats as POST /v1/agent. LOOKALIKE and JOB_SEARCH variables are refused.
Companies to ignore in search results
Keywords that must be present in the profile
ID of the list to associate with this agent
Exclude service providers from results
Skip ICP (Ideal Customer Profile) filter
Include open-to-work profiles in results
Enable lead waterfall mode
Whether the agent is paused
Minimum lead score threshold (0–1)
Whether the visitor tracking script is installed on the website (website-visitor agents)
Max number of credits per month
Response
Agent updated
Unique identifier
Display name of the agent
List of target job titles to prospect. Part of the ICP.
List of target industries to prospect. Part of the ICP.
List of target company sizes (e.g. "1-10", "11-50"). Part of the ICP.
List of target geographic locations. Part of the ICP.
List of target company types (e.g. "Public", "Private")
Type of agent: "autopilot", "lookalike" or "website-visitor"
"autopilot"
Whether the visitor tracking script is installed on the website (website-visitor agents)
Credits consumed so far in the current period (e.g. website-visitor company identifications)
Whether the agent is paused and will not run on its next scheduled time
Whether to exclude service provider companies from prospecting
Whether to skip the ICP (Ideal Customer Profile) filter when sourcing leads
Whether to include LinkedIn profiles marked as open to work
Whether to use the lead waterfall strategy (cascade through multiple sources)
ID of the account (user) who owns this agent
Creation timestamp
Last update timestamp
Additional free-text targeting criteria
Variables used by the agent to find high intent leads. (Keywords, Competitor Page URL, etc.)
Company names to exclude from prospecting. Part of the ICP.
Keywords that must be present in a lead profile to be included
Snitcher tracking script ID, used as the profileId in the tracking snippet (website-visitor agents)
Max number of credits per month
200
Timestamp of the last agent execution
Minimum lead score threshold (0.00–1.00) required to include a lead
0.75
ID of the list this agent sources contacts into
.png?fit=max&auto=format&n=fLzJlZyi7L0nfF9B&q=85&s=7dc539f8ea9f771a09a9750c1227ebdb)
.png?fit=max&auto=format&n=fLzJlZyi7L0nfF9B&q=85&s=e742bcbb4bd47cd295da36c48cdd6089)