# Changelog

This page tracks notable changes to the IntelCenter API.

---

## v1.3.1

**Release Date:** 2026-09-02

### Improvements

- Geo Manifest traversal now uses deterministic newest-first ordering and materially improves filtered traversal performance.
- Geo continuation cursors must be reused only with the exact original request parameters. If a cursor is rejected, restart the same request without a cursor.
- Public JSON errors now omit internal trace, request, deployment-build and infrastructure identifiers while retaining useful status and remediation fields.
- Developer Portal runtime dependencies were updated without changing the documented API contract.

### Compatibility

- No routes, request fields or response fields were removed.
- Authentication, authorization, quotas and rate-limit behavior remain unchanged.
- Continuation cursors created before this release should be restarted by repeating the original request without a cursor.

---

## v1.3.0

**Release Date:** 2026-08-24

### Added

- Direct Component ID lookup documentation for ICD and ICDB video and image records.
- Geo Manifest endpoint coverage for map-oriented integrations.
- Expanded MCP tool documentation, including Component ID and Geo Manifest tools.
- MCP behavior annotations so compatible clients can distinguish retrieval tools from Domain GenAI operations.
- A complete endpoint inventory and a dedicated limitations guide.

### Improvements

- Materially improved keyword-search performance. Request and response contracts are unchanged.
- Substantially improved multi-turn Domain GenAI conversation quality and continuity for follow-up questions, with documented lifecycle controls.
- Stronger layered edge security, managed transport protection, malicious-traffic filtering, denial-of-service resistance, and coordinated rate protections.
- More accurate response examples, navigation, access guidance, and integration patterns.

### Deprecations

The following Domain GenAI response fields are deprecated compatibility aliases:

- `rag_prompt_tokens` → use `usage.prompt_tokens`
- `rag_output_tokens` → use `usage.output_tokens`
- `rag_total_tokens` → use `usage.total_tokens`

They remain available in v1.3.0. Removal will not occur before v2.0.0 and will be preceded by at least 90 days of notice.

### Compatibility

- No routes were removed.
- Authentication, authorization, quotas, and rate-limit behavior remain compatible.
- Keyword search remains supported. When a Component ID is already known, use the dedicated Component ID endpoint instead of keyword search.

---

## v1.2.0

**Release Date:** 2026-08-23

### Added

- Server-generated identifiers for new ICD and ICDB Domain GenAI conversations.
- Credential-bound multi-turn conversation continuity.
- A 60-minute inactivity deadline and fixed 24-hour maximum lifetime.
- Non-billable, idempotent conversation deletion:
  - `DELETE /v1/icd/domain-genai/conversations/{conversation_id}`
  - `DELETE /v1/icdb/domain-genai/conversations/{conversation_id}`
- A documented Domain GenAI success-response schema and usage fields.

### Improvements

- Improved multi-turn follow-up quality and continuity.
- Conversation expiration no longer advances on failed or blocked requests.
- Consistent `conversation_unavailable` responses for unavailable conversation identifiers.
- Automated removal of expired API conversation context.

### Compatibility

- Existing Domain GenAI POST paths, authentication, dataset permissions, entity restrictions, billing, quotas, and rate limits remain unchanged.
- Existing integrations may continue omitting `conversation_id` for independent questions.
- CORS behavior is unchanged.
- Conversation deletion is REST-only and is not added to MCP.

---

## v1.1.0

**Release Date:** 2026-04-30

### Added

- Natural Language Search endpoints:
  - `/v1/icd/nl-search`
  - `/v1/icdb/nl-search`
- Domain GenAI endpoints:
  - `/v1/icd/domain-genai`
  - `/v1/icdb/domain-genai`
- Expanded MCP tool support for Natural Language Search and Domain GenAI.

### Improvements

- Enhanced MCP descriptions and tool clarity.
- Improved error response consistency.
- Updated and expanded documentation.
- Improved permission handling across datasets and features.

### Notes

- This release is fully backward compatible.
- Existing integrations continue to function without modification.

---

## v1.0.0

**Release Date:** 2026-04-04

Initial public release of the IntelCenter API.

### Features

- ICD and ICDB video and image datasets
- Search and filtering
- Retrieval by UUID
- Media access
- MCP support
- API key authentication
- Rate limiting and quota enforcement