Get Agent Read a single agent configured for your workspace.
Returns a single agent by its id, with its current configuration. Returns 404 when the agent does not exist.
GET /api/v2/agents/{agent_id}
Parameter Type Description agent_id integer Identifier of the agent.
cURL JavaScript Node.js Python
curl "https://api.getsillage.com/api/v2/agents/42" \ -H "Authorization: Bearer $SILLAGE_API_KEY " const response = await fetch ( 'https://api.getsillage.com/api/v2/agents/42' , { headers: { Authorization: `Bearer ${ process . env . SILLAGE_API_KEY }` , }, }) const result = await response. json () import { request } from 'node:https' const req = request ( new URL ( 'https://api.getsillage.com/api/v2/agents/42' ), { headers: { Authorization: `Bearer ${ process . env . SILLAGE_API_KEY }` , }, }, ( res ) => { let data = '' res. on ( 'data' , ( chunk ) => { data += chunk }) res. on ( 'end' , () => { console. log ( JSON . parse (data)) }) }, ) req. end () import os import requests response = requests.get( "https://api.getsillage.com/api/v2/agents/42" , headers = { "Authorization" : f "Bearer { os.environ[ 'SILLAGE_API_KEY' ] } " }, timeout = 30 , ) response.raise_for_status() result = response.json() { "data" : { "id" : 42 , "name" : "LinkedIn keyword monitor" , "type" : "keyword_detection" , "enabled" : false , "parameters" : { "tracking_keywords" : [ "fundraising" , "series a" , "hiring sales" ], "start_date" : "2026-01-01" }, "watchlist_kind" : "company" , "watchlist_id" : 128 , "created_at" : "2026-06-18T10:00:00.000Z" , "updated_at" : "2026-06-18T10:00:00.000Z" } } Field Type Description data.id integer Identifier of the agent. data.name string Display name of the agent. data.type string Agent type. One of: keyword_detection, job_posting_keyword_detection, competitor_activity, job_update, content_engagement, champion_tracking, influencer_engagement, job_posting, a semantic watchlist type (competitor, partner, customer, influencer, champion), or unconfigured (agent with no watchlist — not yet set up, or its watchlist was unbound; empty parameters, null watchlist fields). data.enabled boolean Whether the agent is currently active. data.parameters object Type-dependent parameters. See the parameters shape table below. data.watchlist_kind string Kind (company/profile) of the bound watchlist, or null when the agent is unbound. data.watchlist_id integer Id of the bound watchlist, or null when the agent is unbound. data.created_at string ISO 8601 creation timestamp. data.updated_at string ISO 8601 last-update timestamp.
The parameters object fields depend on the agent type. All fields are optional in the response (legacy rows may be sparse).
Field Type Description tracking_keywords array<string> Keywords Sillage monitors on LinkedIn. start_date string ISO 8601 date — only posts published after this date are scraped.
Field Type Description tracking_keywords array<string> Keywords Sillage monitors in your tracked companies' job postings.
Field Type Description job_titles array<string> Job titles that trigger detection. seniority_levels array<string> Seniority levels to filter on. company_domains_to_scrape array<string> Target company domains. target_persona array<string> Target persona labels. target_persona_locations array<string> Geographic filters for target personas. interested_by object { prospects: boolean, customers: boolean } filters.keywords_for_social_detection array<string> Keywords used for social post matching. author_roles array<string> Author role filters. author_industries array<string> Author industry filters. target_linkedin_profiles array<string> Specific LinkedIn profile URLs to track.
Field Type Description job_titles array<string> Job titles to watch for in postings. search_strings array<string> Free-text search strings for job posting content. job_locations array<string> Geographic filters for job postings. published_at string ISO 8601 date — only postings published after this date. target_top_accounts_only boolean Restrict to top-account companies only.
These types share the common targeting parameter set:
Field Type Description company_domains_to_scrape array<string> Target company domains. target_persona array<string> Target persona labels. target_persona_locations array<string> Geographic filters for target personas. interested_by object { prospects: boolean, customers: boolean } filters.keywords_for_social_detection array<string> Keywords used for social post matching. author_roles array<string> Author role filters. author_industries array<string> Author industry filters. target_linkedin_profiles array<string> Specific LinkedIn profile URLs to track.
Same common targeting fields as above, plus:
Field Type Description influencer_keywords array<string> Keywords that identify influencer content.
Status Description 401 The API key is missing or invalid. 404 The agent does not exist. 422 Invalid agent_id — must be a positive integer. 429 Too many requests.