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

# Changelog

> Changes to the Vort Partner API, newest first.

Within `v1` every change is additive (see the [versioning policy](/introduction#versioning-policy)); breaking changes ship only as `/v2`, announced in advance.

<Update label="2026-10-01" description="Docs" tags={["Docs"]}>
  ## Documentation site published

  This documentation now has a hosted home, with an interactive API reference generated from the OpenAPI file. No API changes.
</Update>

<Update label="2026-09-30" description="v1" tags={["Release"]}>
  ## v1: first release

  First release of the Vort Partner API.

  **Endpoints**

  | Method | Path | Purpose |
  | - | - | - |
  | `POST` | `/v1/activations/redeem` | [Connect a customer organization](/api-reference/activation/redeem) with a one-time activation code. |
  | `POST` | `/v1/users` | [Register a recruiter](/api-reference/users/register) (an API-only identity, never a credential). |
  | `POST` | `/v1/jobs` | [Create or update a job](/api-reference/jobs/upsert). |
  | `POST` | `/v1/runs` | [Start a matching run](/api-reference/runs/start), with requirement validation (at most 3 musts). |
  | `GET` | `/v1/runs/{run_id}` | [Read a run's status, progress, notices and candidates](/api-reference/runs/get). |
  | `POST` | `/v1/runs/{run_id}/candidates/{candidate_id}/reveal` | [Reveal a candidate's contact details](/api-reference/candidates/reveal) (charges credits). |
  | `POST` | `/v1/runs/{run_id}/decisions` | [Report recruiter decisions and the notices shown](/api-reference/decisions/report). |

  **Webhooks:** `run_completed`, `run_failed` and `candidate_revealed`, signed with HMAC-SHA256 in `x-vort-signature`, retried up to 8 times over about 8 hours. See [Webhooks](/webhooks).

  **Notices:** a catalogue of stable codes with the generic-rendering rule for codes your client does not know. See [Notices](/notices).

  **Rate limits:** per partner, 120 requests per minute and 20,000 per day by default.

  **Languages:** Hebrew and English (`x-vort-lang`).

  **Sandbox and certification:** a sandbox with certification fixtures, simulated errors and test webhooks, and a 22-item go-live checklist. See [Sandbox](/sandbox) and [Certification](/certification).
</Update>