Talentino API Docs
How to use the Talentino Partner API and the backend processing pipeline.
These docs cover three API surfaces:
- The Partner API v1 (
/api/v1) - the public, API-key-authenticated surface for pushing work into Talentino: importing Resumes and launching Job Matches programmatically. - The Pipeline API (internal) - the three talentino-sst endpoints that drive the Step Functions state machines behind Resume Processing, Job Matching, and Import Activities. These are internal triggers, not partner-callable.
- The Missing Info Mailer API (internal) - the Cloud Run microservice used by the Talentino app to request missing candidate information, send emails, detect replies, and update Resume data.
Audience: Talentino engineers. The site is internal for now; some content (the internal Pipeline API in particular) is not intended for external partners.
Start here
Getting Started
Mint an API key and make your first call.
Authentication & Rate Limits
Bearer keys, what they grant, and the per-key limit.
Ingestion Semantics
How documents are fetched, validated, deduped, and processed.
Pipeline Overview
The state machines your API calls trigger.
Missing Info Microservice
Candidate outreach, reply detection, and database update flow.
API reference
Partner API v1
POST /resumes, /resumes/bulk, /job-matches.
Pipeline API (internal)
/start-processing, /process-resume, /process-import-activity.
Missing Info Mailer API
/missing-info-requests, verification checks, and Pub/Sub webhooks.
Domain terms
The reference uses Talentino's canonical vocabulary. The core nouns:
- Resume - an imported candidate document and the structured data extracted from it.
- Import Activity - a batch/grouping that Resumes are imported under; drives processing.
- Job Match - scoring a pool of candidate Resumes against a job position.
- Resume Score - the aggregate match score (with per-facet Scores) produced by the Scoring context.
- Business Unit - the tenant; every API key, Resume, and Job Match is scoped to one.
- Communication Activity - the persisted audit/work item for an outbound candidate email and its reply-processing lifecycle.