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

# Changelog

> Recent updates and improvements to the Unomiq platform.

### 2026-03-03

**Python SDK**

* Released [Unomiq Python SDK](https://github.com/unomiq-ai/python-sdk) v0.1.1 with:
  * `UnomiqGateway` — Send OpenTelemetry traces to the Unomiq Gateway API with automatic OAuth2 token acquisition and refresh.
  * `UnomiqEconomicsEngine` — Query traces, retrieve metrics, and access live trace data from the Unomiq Engine API with composable AND/OR filters.
  * Automatic & manual unit attachment — Attach `unomiq.unit` / `unomiq.parent_unit` span attributes via resolver callables or per-span helpers (`set_unit`, `set_parent_unit`).

***

### 2026-03-02

**Economics Engine API**

* Add `parent_unit` field and filter (equivalent to` unomiq.parent_unit` resource attribute)

### 2026-02-26

**OAuth API**

* The OAuth `/token` endpoint can now refresh tokens (`grant_type` = `refresh_token`).

### 2026-02-23

**OAuth API**

* The OAuth `/token` endpoint now accepts an `audience` parameter to request tokens scoped to different APIs.

**Management API, Economics Engine API**

* API key tokens can now be used for authentication.

***

### 2026-02-22

**Management API**

* API keys can now be created with multiple permissions in a single request.

***

### 2026-02-21

**Management API**

* API key secrets no longer include special characters for improved compatibility.

***

### 2026-02-14

**Gateway API**

* API key permissions are now validated when requesting an OAuth token — requests with insufficient permissions are rejected with a clear error.

***

### 2026-02-13

**Gateway API**

* API documentation is now auto-generated from the source, keeping specs always up to date.
* Simplified the token acquisition flow: the OAuth token endpoint now clearly references the Unomiq OAuth API.

***

### 2026-02-12

**Economics Engine API**

* Renamed resource attribute for unit field to align with updated naming conventions.

***

### 2026-02-11

**Gateway API**

* Renamed span attributes for user and app identifiers to align with the updated platform naming conventions.

***

### 2026-02-03

**All APIs**

* Added trailing slash support for all routes.

***

### 2026-02-02

**Economics Engine API**

* Improved numeric filter validation: invalid operators and values are now rejected with clear errors.

***

### 2026-01-30

**Economics Engine API**

* Added `duration` and `cost` as filterable fields on spans.
* Added query parameter to restrict search to root spans only.

***

### 2026-01-28

**Economics Engine API**

* Added `unit` field to span responses.
* Added pagination support for the traces listing endpoint.
* Renamed root traces route for consistency.
* Added filtering support for root traces.

***

### 2026-01-27

**Economics Engine API**

* Search window for root traces and trace details is now limited to a maximum of 7 days.

***

### 2026-01-26

**Economics Engine API**

* Requests for live traces that exceed a 24-hour time interval now return a clear error.

***

### 2026-01-25

**Economics Engine API**

* Added a metrics endpoint for aggregated trace data.
* Added more span fields available for direct filtering.

***

### 2026-01-21

**Economics Engine API**

* Added `service_name` field to trace responses.
* Added `min_start_time` to root trace responses.

**Management API**

* Removed `total_pages` from paginated responses.

***

### 2026-01-20

**Economics Engine API**

* Span and resource attributes are now returned as structured dictionaries for easier access.

***

### 2026-01-19

**Economics Engine API**

* Live traces can now be queried within a specified time interval.
* Added pagination support for the live traces endpoint.
* Internal authentication attributes are no longer included in trace responses.

***

### 2026-01-16

**Economics Engine API**

* Added support for listing root traces.

***

### 2026-01-15

**Economics Engine API**

* Added endpoint to retrieve a single trace by ID.

***

### 2026-01-14

**Economics Engine API**

* Initial traces API is now available.
* Added endpoint to read a single trace or span.

***

### 2026-01-05

**Management API**

* Application name is now returned in create and update responses.
* Stricter validation when saving organization data.

***

### 2026-01-04

**Management API**

* API keys are now created with a name for easier identification.
* All API fields now use consistent `snake_case` naming.

***

### 2026-01-02

**Management API**

* Added tax ID field to organizations.
* User role is now returned when creating an organization.

***

### 2025-12-31

**Management API**

* API keys are automatically removed when their associated application is deleted.
* Support for rotating API key secrets and updating permissions.
* Support for listing, reading, and deleting API keys.

***

### 2025-12-30

**Management API**

* Assign and update permissions on API keys.
* Create API keys.
* Create, read, update, and delete applications.
* Applications support soft delete.
* Organizations support soft delete.

***

### 2025-12-29

**Management API**

* List applications per organization.
* Create, list, read, update, and delete organizations.

***

### 2025-12-21

**Management API**

* Role-based access control (RBAC) introduced for all resources.
* Update user email.

***

### 2025-12-20

**Management API**

* Update user name.

***

### 2025-11-28

**All APIs**

* Initial API specifications created.