> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/docs.facephi-en/sdks/backend-sdk/iad/release_notes/1.0.0_release_notes.md).

# 1.0.0

**Release date:** February 3, 2026

## Overview

First major release of **Facephi IAD Service**, featuring standardized API endpoints, improved Docker integration, and enhanced engine management.

This release includes breaking changes to endpoint paths. All endpoints now use the prefix `/iad` to ensure consistency across the Facephi ecosystem.

## What's New

### Endpoint standardization (breaking change)

All API endpoints now use standardized paths with the prefix `/iad`:

| Old endpoint            | New endpoint                |
| ----------------------- | --------------------------- |
| `/api/v1/check-capture` | `/api/v1/iad/check-capture` |
| `/api/v1/extract-image` | `/api/v1/iad/extract-image` |
| `/api/v1/extract_data`  | *Removed*                   |
| `/api/v1/version`       | `/api/v1/iad/version`       |
| `/api/v1/health`        | `/api/v1/iad/health`        |
| `/api/v1/config`        | `/api/v1/iad/config`        |

### Improved Docker integration

* Automatic Docker environment detection
* Self-managed engine initialization inside the container
* Improved process lifecycle management
* Optimized health check times

### License-based engine activation

* Automatic engine activation using license metadata
* Seamless deployment with embedded license configuration
* Reduced manual configuration steps

### Compatibility improvements

* Added filesystem compatibility for GCC 7
* Improved cross-platform build support

## Breaking Changes

⚠️ **Action required:**

### 1. Update the API endpoints

All client integrations must update the endpoint paths to include the prefix `/iad`.

**Before:**

```bash
curl -X POST http://localhost:6982/api/v1/check-capture
```

**After:**

```bash
curl -X POST http://localhost:6982/api/v1/iad/check-capture
```

### 2. Remove references to `extract_data`

The endpoint `/extract_data` has been removed. Use `/iad/extract-image` instead.

## Migration guide

### Step 1: Update the client code

Replace all endpoint URLs:

```diff
- const url = 'http://localhost:6982/api/v1/check-capture';
+ const url = 'http://localhost:6982/api/v1/iad/check-capture';
```

### Step 2: Update monitoring

Update the health check endpoints in your monitoring tools:

```diff
- GET /api/v1/health
+ GET /api/v1/iad/health
```

### Step 3: Test the integration

Verify that all API calls work with the new endpoints before deploying to production.

## Deployment

```bash
docker pull facephicorp.jfrog.io/docker-pro-fphi/facephi-iad-service:1.0.0

docker run -d \
  -p 6982:6982 \
  -v /path/to/license:/app/license \
  -v /path/to/config:/app/config \
  --name iad-service \
  facephicorp.jfrog.io/docker-pro-fphi/facephi-iad-service:1.0.0
```

## Requirements

| Component        | Requirement                              |
| ---------------- | ---------------------------------------- |
| Operating system | Linux x86\_64 (Ubuntu 24.04 recommended) |
| License          | Valid Facephi license file (v1.0.0+)     |
| IAD Engine       | Compatible engine version                |
| Docker           | For container deployments                |

## Known issues

No issues have been identified in this version.

## Support

For migration assistance or Technical Support, contact your Facephi representative.

## Documentation

* [Installation Guide](https://docs.facephi.com/docs.facephi-en/sdks/backend-sdk/iad/installation/installation_instructions.md)
* [API Reference](https://docs.facephi.com/docs.facephi-en/sdks/backend-sdk/iad/technical_documentation/api_reference.md)
* [Changelog](https://docs.facephi.com/docs.facephi-en/sdks/backend-sdk/iad/changelog.md)
