# Sillage Docs

- Getting Started
  - [What is Sillage](/docs/getting-started): Sillage tells your sales team which accounts to act on right now, and why.
  - [How Sillage works](/docs/getting-started/how-sillage-works): The key concepts behind Sillage in one video — from your persona and top accounts to the signals you act on.
  - [How to get started](/docs/getting-started/how-to-get-started): New to Sillage? Here is the whole journey, from defining your persona to activating your first signals.
  - [Account mapping](/docs/getting-started/account-mapping): How Sillage turns a company name or domain into the real account and the right contacts inside it.
  - [Signals on key accounts](/docs/getting-started/signals-on-key-accounts): What a signal is, how Sillage detects it on your accounts, and how it becomes outreach you can send.
  - [API quickstart](/docs/getting-started/api-quickstart): Generate an API key and make your first Sillage API request.
- API
  - [API](/docs/api): Direct-client API reference for accessing Sillage workspace content and account mapping data.
  - [Authentication](/docs/api/authentication): Authenticate direct-client API requests with a Sillage workspace API key.
  - [Pagination](/docs/api/pagination): Use offset/page pagination for API list endpoints.
  - Top Account
    - [Top Account](/docs/api/top-account): Define and read your workspace's target account list.
    - [Get Ingestion Status](/docs/api/top-account/get-status): Poll the current state of the latest top account list ingestion.
    - [Add Accounts](/docs/api/top-account/add-accounts): Merge accounts into your workspace's top account list.
    - [List Accounts](/docs/api/top-account/list-accounts): List found accounts from your top account list, paginated.
    - [Count Accounts](/docs/api/top-account/count-accounts): Count the found accounts in your top account list.
    - [Not-Found Accounts](/docs/api/top-account/not-found-accounts): List accounts from your top account list that could not be matched.
    - [Remove Account by ID](/docs/api/top-account/remove-account): Remove a single account from your top account list by id.
    - [Remove Accounts](/docs/api/top-account/remove-accounts): Remove accounts from your top account list by domain or LinkedIn URL.
  - Persona
    - [Persona](/docs/api/persona): Define your workspace's ideal customer profile targeting criteria.
    - [Get persona](/docs/api/persona/read-persona): Retrieve your workspace's ideal customer profile targeting criteria.
    - [Upsert persona](/docs/api/persona/upsert-persona): Upsert your workspace's ideal customer profile targeting criteria.
  - Agent
    - [Agent](/docs/api/setup): Create and manage your workspace's agents.
    - [Get Setup State](/docs/api/setup/get-setup-state): Check what is left to configure in your workspace, with a diagnostic checklist.
    - [Create Agent](/docs/api/setup/create-agent): Create an agent for your workspace.
    - [List Agents](/docs/api/setup/list-agents): List the agents configured for your workspace.
    - [Get Agent](/docs/api/setup/read-agent): Read a single agent configured for your workspace.
    - [Update Agent](/docs/api/setup/update-agent): Update an agent configured for your workspace.
    - [Delete Agent](/docs/api/setup/delete-agent): Delete an agent configured for your workspace.
  - Watchlists
    - [Watchlists](/docs/api/watchlists): Reusable lists of companies or people that signal agents watch.
    - [Create Watchlist](/docs/api/watchlists/create-watchlist): Create a reusable company or profile watchlist.
    - [List Watchlists](/docs/api/watchlists/list-watchlists): Paginate the watchlists in your workspace.
    - [Get Watchlist](/docs/api/watchlists/get-watchlist): Read a single watchlist by id.
    - [Update Watchlist](/docs/api/watchlists/update-watchlist): Rename or re-describe a watchlist.
    - [Delete Watchlist](/docs/api/watchlists/delete-watchlist): Delete a watchlist that is not bound to any agent.
    - [Add Entities](/docs/api/watchlists/add-entities): Add companies or people to a watchlist by LinkedIn identity or company domain.
    - [List Entities](/docs/api/watchlists/list-entities): Paginate the members of a watchlist.
    - [Remove Entity](/docs/api/watchlists/remove-entity): Remove one member from a watchlist.
  - Contents
    - [Contents](/docs/api/contents): Read the content items Sillage collects for your workspace.
    - [Query Contents](/docs/api/contents/query-contents): Paginate the content items collected for your workspace.
    - [Get Content](/docs/api/contents/get-content): Retrieve a single content item by ID.
  - Content Requests
    - [Content Requests](/docs/api/content-requests): Read the content requests that drive your workspace content workflows.
    - [List Content Requests](/docs/api/content-requests/list-content-requests): Paginate the content requests that drive your workspace content workflows.
    - [Query Content Requests](/docs/api/content-requests/query-content-requests): POST body variant of the content requests list, for large identifier lists.
    - [Get Content Request](/docs/api/content-requests/get-content-request): Retrieve a single workspace content request by ID.
  - Signal Runs
    - [Signal Runs](/docs/api/signal-runs): Launch a detection run for an agent, poll it to completion, and list runs in progress.
    - [Launch a Signal Run](/docs/api/signal-runs/launch-signal-run): Start a detection run for an agent across your target accounts.
    - [Poll a Signal Run](/docs/api/signal-runs/poll-signal-run): Check a signal run's stage until it reaches a terminal state.
    - [List In-Flight Signal Runs](/docs/api/signal-runs/list-in-flight-signal-runs): See every signal run currently in progress for your workspace.
  - Signals
    - [Signals](/docs/api/signals): List, count, and read the signal detections published for your workspace.
    - [Query Signal Detections](/docs/api/signals/query-signal-detections): Paginate the signal detections published for your workspace.
    - [Count Signal Detections](/docs/api/signals/count-signal-detections): Get the total number of signal detections matching your filters.
    - [Get a Signal Detection](/docs/api/signals/get-signal-detection): Retrieve a single signal detection by ID.
  - Account Mapping
    - [Account Mapping](/docs/api/account-mapping): Resolve a company and retrieve enriched employee profiles for a workspace.
    - [List company mappings](/docs/api/account-mapping/list-company-mappings): List materialized Account Mapping records without employee profiles.
    - [Get company mapping](/docs/api/account-mapping/get-company-mapping): Retrieve one Account Mapping record with enriched employee profiles.
    - [Enrich company mapping](/docs/api/account-mapping/enrich-company-mapping): Resolve a company and start asynchronous Account Mapping enrichment.
  - Companies
    - [Companies](/docs/api/companies): Look up the enrichment data behind a company id returned by Signals.
    - [Get company](/docs/api/companies/get-company): Retrieve a company's data by its company_id.
  - Leads
    - [Leads](/docs/api/leads): Look up the profile data behind a lead id returned by Signals.
    - [Query Leads](/docs/api/leads/list-leads): Paginate the leads in your workspace, sorted by creation date.
    - [Get lead](/docs/api/leads/get-lead): Retrieve a lead's data by its lead_id.
  - [Requests Status](/docs/api/requests-status): Get a snapshot of all work currently being processed in your workspace.
  - [OpenAPI Specification](/docs/api/openapi-specification): Import the Sillage API spec into Postman, Insomnia, or generate an SDK.
- MCP
  - [MCP](/docs/mcp): Connect Claude, Cursor, and other AI assistants to your Sillage workspace over the Model Context Protocol.
  - [Install the MCP](/docs/mcp/install): Connect Claude, Cursor, or any MCP client to your Sillage workspace, then verify it works.
  - [Tool reference](/docs/mcp/tools): Every action an assistant can take in your Sillage workspace over MCP.
- [Skills](/docs/skills): Install the Sillage Skills pack so your assistant knows how to run your workspace, not just which tools exist.
- Playbooks
  - [Playbooks](/docs/playbooks): Recipes that turn Sillage signals into action, each one two ways. Ask your assistant, or build it against the API.
  - [Who to contact today](/docs/playbooks/who-to-contact-today): A morning brief that ranks the accounts where something just happened, so your reps know where to start.
  - [Draft outreach from a signal](/docs/playbooks/draft-outreach): Turn one signal into a short, personalized first message that references what actually happened.
  - [Competitor radar](/docs/playbooks/competitor-radar): See every time a competitor engaged one of your target accounts, and exactly who reached out to whom.
  - [New-buyer tracker](/docs/playbooks/new-buyer-tracker): Catch persona-fit decision makers joining your target accounts, while the relationship is still open.
  - [Signal reference](/docs/playbooks/signal-reference): What each signal type means, who it points to, and a good next step, for all 8 agent types.