Skip to main content
PATCH
Update a source agent

Authorizations

Authorization
string
header
required

API key from Settings → API. Send it as Authorization: Bearer .

Headers

x-impersonate-user-id
string

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

id
number
required

Body

application/json
name
string

Name of the agent

targetJobTitles
string[]

Target job titles to search for

targetIndustries
string[]

Target industries to search in

targetCompanySizes
string[]

Target company sizes

targetLocations
string[]

Target locations to search in

targetCompanyTypes
string[]

Target company types

additionalCriteria
string
deprecated

Additional search criteria or instructions

Maximum string length: 200
agentType
enum<string>

Type of agent, only "autopilot" is accepted

Available options:
autopilot
variables
object[]

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.

ignoredCompanies
string[]

Companies to ignore in search results

mandatoryKeywords
string[]

Keywords that must be present in the profile

listId
number

ID of the list to associate with this agent

excludeServiceProviders
boolean

Exclude service providers from results

skipIcpFilter
boolean

Skip ICP (Ideal Customer Profile) filter

includeOpenToWorkProfiles
boolean

Include open-to-work profiles in results

leadWaterfall
boolean

Enable lead waterfall mode

paused
boolean

Whether the agent is paused

minLeadScore
number

Minimum lead score threshold (0–1)

scriptInstalled
boolean

Whether the visitor tracking script is installed on the website (website-visitor agents)

maxCreditUsage
number

Max number of credits per month

Response

Agent updated

id
number
required

Unique identifier

name
string
required

Display name of the agent

targetJobTitles
string[]
required

List of target job titles to prospect. Part of the ICP.

targetIndustries
string[]
required

List of target industries to prospect. Part of the ICP.

targetCompanySizes
string[]
required

List of target company sizes (e.g. "1-10", "11-50"). Part of the ICP.

targetLocations
string[]
required

List of target geographic locations. Part of the ICP.

targetCompanyTypes
string[]
required

List of target company types (e.g. "Public", "Private")

agentType
string
required

Type of agent: "autopilot", "lookalike" or "website-visitor"

Example:

"autopilot"

scriptInstalled
boolean
default:false
required

Whether the visitor tracking script is installed on the website (website-visitor agents)

currentCreditUsage
number
default:0
required

Credits consumed so far in the current period (e.g. website-visitor company identifications)

paused
boolean
default:false
required

Whether the agent is paused and will not run on its next scheduled time

excludeServiceProviders
boolean
default:false
required

Whether to exclude service provider companies from prospecting

skipIcpFilter
boolean
default:false
required

Whether to skip the ICP (Ideal Customer Profile) filter when sourcing leads

includeOpenToWorkProfiles
boolean
default:false
required

Whether to include LinkedIn profiles marked as open to work

leadWaterfall
boolean
default:true
required

Whether to use the lead waterfall strategy (cascade through multiple sources)

userId
number
required

ID of the account (user) who owns this agent

createdAt
string<date-time>
required

Creation timestamp

updatedAt
string<date-time>
required

Last update timestamp

additionalCriteria
string | null

Additional free-text targeting criteria

variables
string[] | null

Variables used by the agent to find high intent leads. (Keywords, Competitor Page URL, etc.)

ignoredCompanies
string[] | null

Company names to exclude from prospecting. Part of the ICP.

mandatoryKeywords
string[] | null

Keywords that must be present in a lead profile to be included

trackingScriptId
string | null

Snitcher tracking script ID, used as the profileId in the tracking snippet (website-visitor agents)

maxCreditUsage
number | null

Max number of credits per month

Example:

200

lastRun
string<date-time> | null

Timestamp of the last agent execution

minLeadScore
number | null

Minimum lead score threshold (0.00–1.00) required to include a lead

Example:

0.75

listId
number | null

ID of the list this agent sources contacts into