Skip to main content

​
June 12, 2026

​
New Features

  • Candidate Work History Support: Added full support for exposing and managing candidate work histories via the public API and inline candidate creation flows.
    • workHistory Schema: The array items include companyName (required), candidatePosition (required), referenceName (optional), referencePhone (required E.164 phone string for references), startDate (optional yyyy-MM-dd date), and endDate (optional yyyy-MM-dd date).
    • API Endpoints: Supported on candidate creation (POST /candidates), update (PATCH /candidates/{id}), and retrieval (GET /candidates & GET /candidates/{id}).
    • Inline Interview Scheduling: Supported inline workHistory mapping on candidate creation nested inside interview scheduling (POST /interviews).
    • Robust Internal Mapping: Refactored logic to map transparently to/from database schemas using a unified helper.

​
Bug Fixes

  • Interview Creation Validation: Added validation on interview creation (POST /interviews) to ensure the candidate has required contact details matching the chosen interview type.
    • Requires candidate phone number for phone interviews.
    • Requires candidate email address for online interviews.

​
June 11, 2026

​
New Features

  • Sourcing Preview API: A new high-speed endpoint is now available for generating search previews and candidate listings.
    • POST /sourcing/preview — Initiates a candidate sourcing preview run. This endpoint is designed for speed, returning basic candidate details in seconds instead of calling the fully enriched candidate search.
    • GET /sourcing/preview/{id}/results — A dedicated polling endpoint to fetch the state and results of a preview run. Prevents mixing up standard and preview results.
    • Stripped Candidate DTO: The returned candidates are simplified to just 9 essential fields (profileId, fullName, profileUrl, title, headline, location, country, companyName, companyUrl) and exclude deep enrichment features (e.g., contact info, emails, fit points, or red flags).
    • Internal Pagination: Automatically handles pagination internally based on the requested candidate limit (between 1 and 100, default: 20). No need to pass page query parameters.
    • Integration with Existing Flows: The endpoint fits seamlessly into the current asynchronous flows, allowing result retrieval via the new preview results endpoint or webhook delivery using existing SOURCING_COMPLETED and SOURCING_FAILED events.
    • Page-based Credit Cost: Sourcing previews charge 1 credit (or 0.4 minutes) per preview page successfully queried (where each page contains up to 20 candidates), with standard pre-flight validation checks run at initialization.
    • Required Scope: Requires the sourcing:write scope for initiating runs and sourcing:read scope for polling results.