# FreshTalent

> Search, lists, targets, and monitoring on the talent graph — over REST and MCP.

- [Search, lists, targets, monitoring](https://docs.freshtalent.ai/index.md): Search elite engineers, keep a pipeline, and get pinged when someone actually moves — in the dashboard, Claude, or your ATS.
- [Recruiter quickstart](https://docs.freshtalent.ai/quickstart.md): From login to a standing Palantir-leaver Target, without touching an API.
- [Integrator quickstart](https://docs.freshtalent.ai/integrate.md): API key, first search, then Claude or your ATS — the technical path.
- [Build your first integration](https://docs.freshtalent.ai/guides/first-integration.md): Search people, add results to a List, and poll events safely.
- [Authentication](https://docs.freshtalent.ai/authentication.md): API keys for the dashboard, MCP, and REST. Org scoping and 401s.
- [How FreshTalent works](https://docs.freshtalent.ai/loop.md): Search, Companies, Lists, Targets, and Monitoring — what each one is for, and how they connect.
- [Search](https://docs.freshtalent.ai/guides/search.md): Recruiter language and filters compile to the same query. Save the echoed query for repeat graph searches.
- [Availability](https://docs.freshtalent.ai/guides/availability.md): Where each availability flag comes from, how AI exploration detection works, and how to inspect the evidence.
- [Companies](https://docs.freshtalent.ai/guides/companies.md): Browse teams, leavers, and role mix — then turn a company into a Target.
- [Lists](https://docs.freshtalent.ai/guides/lists.md): The pipeline in the sidebar. Stages To contact, Contacted, Responded, Passed.
- [Targets](https://docs.freshtalent.ai/guides/targets.md): Standing people searches and company networks. Accept who to keep, then start monitoring.
- [Monitoring](https://docs.freshtalent.ai/guides/monitoring.md): Feed, Timeline, and Alerts — review profile changes and configure when to get notified.
- [Settings](https://docs.freshtalent.ai/guides/settings.md): Workspace administration, integrations, API keys, billing, and your personal profile.
- [Plays that work](https://docs.freshtalent.ai/guides/plays.md): Concrete searches and Targets recruiters run on FreshTalent — filters the product actually supports.
- [Connect Claude, ChatGPT, Cursor, and other agents](https://docs.freshtalent.ai/mcp-setup.md): Point Cursor, Claude Code, VS Code, or Codex at https://api.freshtalent.ai/mcp. Same API key as REST. Eight tools.
- [ATS, CRM, and outreach](https://docs.freshtalent.ai/connect/ats-crm.md): Poll profile diffs into Greenhouse, Ashby, Lever, HubSpot, or a sequencer. Stages stay in FreshTalent until someone is a real candidate.
- [Rate limits and quotas](https://docs.freshtalent.ai/rate-limits.md): Request buckets, retry headers, and monitoring allocation reported by the API.
- [Errors](https://docs.freshtalent.ai/errors.md): Application and framework error shapes, status codes, and safe retry decisions.
- [API overview](https://docs.freshtalent.ai/api-reference/overview.md): Search the talent graph, manage pipelines, and integrate monitoring events into your systems.
- [Get account](https://docs.freshtalent.ai/api-reference/account/me.md): Authenticated organization, access, plan, quotas, webhook configuration, Slack status, and notification preferences.
- [Search people](https://docs.freshtalent.ai/api-reference/people/search.md): Search the talent graph with structured filters or recruiter-style natural language.
- [Get person](https://docs.freshtalent.ai/api-reference/people/get.md): Fetch a person's full dossier by public identifier, slug, or LinkedIn URL.
- [Person response shapes](https://docs.freshtalent.ai/api-reference/people/schema.md): Exact full and compact person fields, nullability, hydration, and expansions.
- [Search companies](https://docs.freshtalent.ai/api-reference/companies/search.md): Find visible companies by name, key, or LinkedIn URL fragment.
- [Get company orbit](https://docs.freshtalent.ai/api-reference/companies/orbit.md): Get company metadata, role mix, current people, and recent leavers.
- [List lists](https://docs.freshtalent.ai/api-reference/lists/list.md): Return every list visible to the authenticated organization, including generated default lists.
- [Create list](https://docs.freshtalent.ai/api-reference/lists/create.md): Create a custom organization-scoped list with no members.
- [Get list](https://docs.freshtalent.ai/api-reference/lists/get.md): Retrieve list metadata and every membership in one response.
- [Add list members](https://docs.freshtalent.ai/api-reference/lists/add-members.md): Upsert one or more people into a custom list by LinkedIn slug or URL.
- [Update list member](https://docs.freshtalent.ai/api-reference/lists/update-member.md): Partially update a list member's stage or notes.
- [Delete list](https://docs.freshtalent.ai/api-reference/lists/delete.md): Permanently delete a custom list and its memberships.
- [List saved queries](https://docs.freshtalent.ai/api-reference/queries/list.md): Return every saved people-search query for the authenticated organization.
- [Save query](https://docs.freshtalent.ai/api-reference/queries/save.md): Persist a compacted echoed people-search object for later reuse.
- [Get saved query](https://docs.freshtalent.ai/api-reference/queries/get.md): Retrieve one saved people-search query by its UUID.
- [List targets](https://docs.freshtalent.ai/api-reference/targets/list.md): List the authenticated organization's people-search and company-network Targets.
- [Create target](https://docs.freshtalent.ai/api-reference/targets/create.md): Create a people-search or company-network Target and enqueue discovery.
- [Get target](https://docs.freshtalent.ai/api-reference/targets/get.md): Retrieve one Target, its counts, stored query, and latest job summary.
- [Update target](https://docs.freshtalent.ai/api-reference/targets/update.md): Rename a Target and change whether newly discovered members are admitted automatically.
- [Delete target](https://docs.freshtalent.ai/api-reference/targets/delete.md): Delete a Target, cancel its active jobs, and release exclusive graph audience membership.
- [Retry target](https://docs.freshtalent.ai/api-reference/targets/retry.md): Enqueue a fresh discovery job for a Target whose latest work needs another run.
- [List target members](https://docs.freshtalent.ai/api-reference/targets/members.md): List a Target's members with status, people, stint, location, role, and enrichment filters.
- [Accept target members](https://docs.freshtalent.ai/api-reference/targets/admit.md): Set the membership status of selected or filtered Target members; despite the dashboard name, this operation also supports exclude and reset-to-proposed.
- [List events](https://docs.freshtalent.ai/api-reference/events/list.md): Cursor-paginated profile diffs visible on the authenticated organization's Lists and Monitored Target members.
- [Get notification preferences](https://docs.freshtalent.ai/api-reference/signals/get-preferences.md): Read graph-wide profile-diff subscriptions and email/Slack delivery settings.
- [Update notification preferences](https://docs.freshtalent.ai/api-reference/signals/update-preferences.md): Persist graph-wide profile-diff subscriptions and email, Slack, and webhook settings.
- [Send test digest](https://docs.freshtalent.ai/api-reference/signals/test.md): Replay a recent live signal digest to the organization's configured email and Slack destinations.