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

# Overview

> How the Factagora Search API is versioned and what gets recorded

## What is a Changelog?

The changelog tracks notable changes to the Factagora Search API for each version. It is intended for developers integrating with the API, so they can understand what changed, whether it breaks existing code, and what action (if any) is required.

Only changes to the publicly documented APIs are recorded here. Internal endpoints are excluded.

***

## Versioning

The API follows [Semantic Versioning](https://semver.org/): `MAJOR.MINOR.PATCH`.

| Part      | When to increment                                 | Examples                                                     |
| --------- | ------------------------------------------------- | ------------------------------------------------------------ |
| **MAJOR** | Breaking changes: existing client code will break | Removing a field, renaming an endpoint, changing auth method |
| **MINOR** | New features, backwards-compatible                | New endpoint, new optional parameter, new response field     |
| **PATCH** | Bug fixes, backwards-compatible                   | Fixing incorrect response data, performance improvements     |

Versions in the `0.y.z` range are considered early development, so anything may change. Stability is guaranteed from `1.0.0` onwards.

***

## What Gets Recorded

Changes to the following endpoints are tracked in this changelog:

| Endpoint                            | Description            |
| ----------------------------------- | ---------------------- |
| `GET /api/v1/fact-search`           | Fact Search            |
| `POST /api/v1/fact-checker`         | Fact Checker           |
| `POST /api/v1/evidence-finder`      | Evidence Finder        |
| `POST /api/v1/deep-research`        | Deep Research          |
| `POST /api/v1/timeseries`           | Timeseries             |
| `POST /api/v1/timeseries/file`      | Timeseries (file)      |
| `POST /api/v1/causality-graph`      | Causality Graph        |
| `POST /api/v1/causality-graph/file` | Causality Graph (file) |
| `POST /api/v1/fingerprint/embed`    | Fingerprint Embed      |
| `POST /api/v1/fingerprint/detect`   | Fingerprint Detect     |

***

## Change Categories

Each release groups changes into the following categories:

| Category     | Meaning                                          |
| ------------ | ------------------------------------------------ |
| `Added`      | New feature or endpoint                          |
| `Changed`    | Change to existing behavior                      |
| `Deprecated` | Feature that will be removed in a future version |
| `Removed`    | Feature that has been removed                    |
| `Fixed`      | Bug fix                                          |
| `Security`   | Security vulnerability addressed                 |