phantombuster.api.* operation is listed below with parameter shapes and return types from the plugin Zod schemas.
Agents
delete
agents.delete
Delete a PhantomBuster agent by ID
Risk: destructive
fetch
agents.fetch
Get details for a specific PhantomBuster agent by ID
Risk: read
fetchAll
agents.fetchAll
Get all PhantomBuster agents (Phantoms) in the organization
Risk: read
object[]
Output full type
Output full type
fetchDeleted
agents.fetchDeleted
Get all deleted agents in the organization
Risk: read
object[]
Output full type
Output full type
fetchOutput
agents.fetchOutput
Get the output of the most recent container for an agent, including status, progress, console log, and result object
Risk: read
launch
agents.launch
Add a PhantomBuster agent to the launch queue
Risk: write
argument full type
argument full type
arguments full type
arguments full type
bonusArgument full type
bonusArgument full type
launchSoon
agents.launchSoon
Schedule a PhantomBuster agent to launch before a specific time
Risk: write
argument full type
argument full type
arguments full type
arguments full type
save
agents.save
Create a new agent or update an existing one
Risk: write
argument full type
argument full type
stop
agents.stop
Stop a currently running PhantomBuster agent
Risk: write
unscheduleAll
agents.unscheduleAll
Disable automatic launch for all agents in the organization
Risk: write
Branches
create
branches.create
Create a new branch
Risk: write
delete
branches.delete
Delete a branch by ID
Risk: destructive
fetchAll
branches.fetchAll
Fetch all branches in the organization
Risk: read
object[]
Output full type
Output full type
fetchDiff
branches.fetchDiff
Get the staging/release diff for script branches
Risk: read
object[]
Output full type
Output full type
release
branches.release
Release a script branch
Risk: write
Containers
fetch
containers.fetch
Get details for a specific run container by ID
Risk: read
fetchAll
containers.fetchAll
Get all run containers for a specific agent
Risk: read
containers full type
containers full type
fetchOutput
containers.fetchOutput
Get the console output for a specific container
Risk: read
fetchResultObject
containers.fetchResultObject
Get the result object (JSON data) from a specific container
Risk: read
Identities
generateToken
identities.generateToken
Generate an identity token
Risk: write
saveEvent
identities.saveEvent
Save an identity event
Risk: write
event_data full type
event_data full type
Leads
deleteMany
leads.deleteMany
Delete multiple leads by their IDs
Risk: destructive
fetchByList
leads.fetchByList
Fetch leads belonging to a specific lead list
Risk: read
paginationOptions full type
paginationOptions full type
leads full type
leads full type
save
leads.save
Save a single lead to PhantomBuster org storage
Risk: write
lead full type
lead full type
saveMany
leads.saveMany
Bulk-save multiple leads to PhantomBuster org storage
Risk: write
leads full type
leads full type
object[]
Output full type
Output full type
Lists
delete
lists.delete
Delete a lead list by ID
Risk: destructive
fetch
lists.fetch
Get details for a specific lead list by ID
Risk: read
fetchAll
lists.fetchAll
Get all lead lists in the organization
Risk: read
object[]
Output full type
Output full type
save
lists.save
Create a new lead list or update an existing one
Risk: write
Misc
fetchIpLocation
misc.fetchIpLocation
Retrieve the country of an IP address
Risk: read
requestAiCompletion
misc.requestAiCompletion
Request a text completion from the AI module
Risk: write
messages full type
messages full type
solveHCaptcha
misc.solveHCaptcha
Solve an hCaptcha challenge
Risk: write
solveRecaptcha
misc.solveRecaptcha
Solve a reCAPTCHA challenge (v2 or v3)
Risk: write
Orgs
exportAgentUsage
orgs.exportAgentUsage
Export agent usage CSV for the organization
Risk: read
string
exportContainerUsage
orgs.exportContainerUsage
Export container usage CSV for the organization
Risk: read
string
fetch
orgs.fetch
Get the current organization info
Risk: read
fetchAgentGroups
orgs.fetchAgentGroups
Get agent groups and order for the organization
Risk: read
object[]
Output full type
Output full type
fetchResources
orgs.fetchResources
Get the organization resource usage (slots, limits)
Risk: read
fetchRunningContainers
orgs.fetchRunningContainers
Get the organization’s running containers
Risk: read
containers full type
containers full type
saveAgentGroups
orgs.saveAgentGroups
Update agent groups and order for the organization
Risk: write
agentGroups full type
agentGroups full type
agentGroups full type
agentGroups full type
Scripts
delete
scripts.delete
Delete a script by ID
Risk: destructive
fetch
scripts.fetch
Fetch a script by ID
Risk: read
branches full type
branches full type
fetchAll
scripts.fetchAll
Fetch all scripts for the current user
Risk: read
object[]
Output full type
Output full type
fetchCode
scripts.fetchCode
Get the code of a script
Risk: read
save
scripts.save
Create a new script or update an existing one
Risk: write
updateAccessList
scripts.updateAccessList
Update a script’s access list
Risk: write
updateVisibility
scripts.updateVisibility
Update the visibility of a script
Risk: write
Storage
deleteLeadObjects
storage.deleteLeadObjects
Delete lead objects from organization storage
Risk: destructive
saveCompanyObject
storage.saveCompanyObject
Save a company object to organization storage
Risk: write
properties full type
properties full type
properties full type
properties full type
saveLeadObject
storage.saveLeadObject
Save a lead object to organization storage
Risk: write
properties full type
properties full type
properties full type
properties full type
saveManyCompanyObjects
storage.saveManyCompanyObjects
Bulk-save company objects to organization storage
Risk: write
objects full type
objects full type
object[]
Output full type
Output full type
saveManyLeadObjects
storage.saveManyLeadObjects
Bulk-save lead objects to organization storage
Risk: write
objects full type
objects full type
object[]
Output full type
Output full type
searchCompanyObjects
storage.searchCompanyObjects
Search company objects in organization storage
Risk: read
object
Output full type
Output full type
searchLeadObjects
storage.searchLeadObjects
Search lead objects in organization storage
Risk: read
object
Output full type
Output full type
Users
fetchMe
users.fetchMe
Get info about the currently authenticated PhantomBuster user
Risk: read
user full type
user full type
updateMe
users.updateMe
Update the current user’s info
Risk: write