> 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.2.0_release_notes.md).

# 1.2.0

**Release date:** April 30, 2026

## General overview

**Facephi IAD Service 1.2.0** is a minor version focused on hardening License Initialization and on documentation accuracy. This version does not introduce changes to the API endpoints or the configuration schema.

## Changes

### Hardening of License Initialization

* **Embedded product credentials** — The service now applies the build-time Cryptlex product credentials for IAD during license initialization.
* **License file handling** — If `LICENSE_ID` or `LICENSE_DATA` are present in the license file, the service ignores them and uses the embedded product credentials instead.

### Documentation and API reference alignment

* **Engine rejection reasons** — The API documentation now lists the engine rejection reasons returned in `capture.rejection`.
* **Validation error codes** — The API and OpenAPI documentation now document the values of `error_code` of the engine exposed by HTTP responses `400`.
* **Operational examples** — The Docker, OpenAPI, and configuration examples were aligned with the current version metadata, `1.2.0` default runtime values, and endpoint paths `/api/v1/iad/*`.

## Compatibility

* Existing API clients continue to work unchanged.
* The files `config.json` existing continue to work unchanged.
* Existing license files continue to work. If your provisioning templates still populate `LICENSE_ID` or `LICENSE_DATA`, those values no longer have any effect and can be removed for clarity.

## Upgrade guide

This version does not require API or configuration migration. To upgrade:

1. Update the Docker image tag to `1.2.0`.
2. Redeploy the service.
3. Verify the running version using `GET /api/v1/iad/version`.
4. Review the license provisioning templates and stop relying on `LICENSE_ID` or `LICENSE_DATA` if they are being generated.

## Deployment

```bash
docker pull facephicorp.jfrog.io/docker-pro-fphi/facephi-iad-service:1.2.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.2.0
```

## Requirements

| Component        | Requirement                              |
| ---------------- | ---------------------------------------- |
| Operating system | Linux x86\_64 (Ubuntu 24.04 recommended) |
| License          | Valid Facephi License file               |
| Docker           | For container deployment                 |

## Known issues

No issues have been identified in this version.

## Support

For Technical Support, contact your Facephi representative.

## Documentation

* [Configuration reference](/docs.facephi-en/sdks/backend-sdk/iad.md)
* [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)