> 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

## General overview

First major Version of **Facephi IAD Service**, with standardized API Endpoints, improved Docker Integration, and improved engine management.

This version includes breaking changes in the Endpoint paths. All Endpoints now use the prefix `/iad` to maintain 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 detection of the Docker environment
* Self-managed Initialization of the engine inside the container
* Improved process lifecycle management
* Optimized health check times

### License-based engine activation

* Automatic engine activation using the License metadata
* Frictionless deployment with embedded License configuration
* Reduction in manual configuration steps

### Compatibility improvements

* File system compatibility for GCC 7 was added
* Cross-platform build support was improved

## Breaking changes

⚠️ **Required action:**

### 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 the 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 deployment 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 deployment                 |

## Known issues

No issues have been identified in this version.

## Support

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

## Documentation

* [Installation guide](/docs.facephi-en/sdks/backend-sdk/iad/installation/installation_instructions.md)
* [API reference](/docs.facephi-en/sdks/backend-sdk/iad/technical_documentation/api_reference.md)
* [Changelog](/docs.facephi-en/sdks/backend-sdk/iad/changelog.md)