# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [1.4.0] - 2026-04-07

### Added

- **User** -- New fields `professionCode` (nullable string) and `professionLabel` (nullable string) on user profile, sourced from PSC (Pro Santé Connect) identity provider.
- **Patient** -- New filter parameters `finess` and `finess[]` on `GET /patients` for FINESS establishment filtering.


### Changed

- **User** -- RPPS validation relaxed from strict 11-digit numeric (`^\d{11}$`) to flexible alphanumeric (`^[A-Za-z0-9]+$`, maxLength: 20) to support international practitioner identifiers.
- **User** -- Fields `gender` and `phone` are no longer required on the user profile.


## [1.3.0] - 2026-03-30

*No public API changes. Internal-only: added `write:sts_tokens` OAuth scope for Electron STS token management.*

## [1.2.0] - 2026-03-30

### Added

- **Audio** -- New filter parameter `exists[meeting]` on `GET /audios` to filter audios by meeting association.
- **Patient** -- New filter parameter `exists[meeting]` on `GET /patients`.
- **Document** -- New filter parameter `exists[meeting]` on `GET /documents`.


## [1.1.0] - 2026-02-24

### Added

- **Note** -- New read-only resource with two endpoints: retrieve a collection of notes (`GET /notes`) and retrieve a single note (`GET /notes/{uuid}`). Filterable by uuid, type, patient, audio, createdAt, updatedAt. Sortable by uuid, type, createdAt, updatedAt. Scope: `read:notes`.


### Removed

- **Audio** -- Removed filter parameters `summary` and `summary[]` from `GET /audios`.


## [1.0.0] - 2025-04-29

### Added

#### Askara API Reference (`api.askara.ai`)

- Published the OpenAPI 3.1.0 specification for the Askara public API with OAuth2 authorization code security scheme.
- **Audio** -- Endpoints to retrieve a collection of audios and retrieve a single audio by UUID (read-only). Supports pagination, ordering, text search, and patient expand filters.
- **Contact** -- Endpoints to list, create, retrieve, and update contacts. Supports pagination, ordering, text search, and archive filtering.
- **Document** -- Endpoints to list documents, retrieve a single document, and set a document synchronization status. Supports filtering by synchronization state for integration workflows.
- **Organization** -- Endpoints to list organizations and retrieve a single organization by UUID (read-only).
- **Patient** -- Endpoints to list, create or update (upsert), retrieve, and patch patients. Supports pagination, ordering, text search, external ID matching, and archive filtering.
- **User** -- Endpoints to retrieve the current authenticated user (`/me`) and retrieve a user by UUID (read-only).
- **Webhook** -- Endpoints to list, create, retrieve, update, and delete webhooks for event-driven integrations.


#### SpeechToText API Reference (`stt.askara.ai/v2`)

- Published the OpenAPI 3.1.0 specification for the Askara SpeechToText API, secured via API key (`X-API-KEY` header).
- **Transcription** -- Asynchronous endpoint to submit an audio file URL for speech-to-text processing with a callback URL for result delivery.