> ## Documentation Index
> Fetch the complete documentation index at: https://docs.instaview.sk/llms.txt
> Use this file to discover all available pages before exploring further.

# June 2026

> Changelog entries for June 2026

## 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.