All notable changes to this project will be documented in this file. See Keep a CHANGELOG for how to update this file. This project adheres to Semantic Versioning.
0.6.0 (2026-08-04)
Features
- audit-roles-tasks: add read-only resources (Audit Events, Roles, Tasks, OKRs, Webhook Events) (#107) (f49fe3e)
- client: convert snake_case body keys to camelCase (#94) (ac6b555)
- companies: add retrieve/2, deprecate get/2 (#99) (f50bed4)
- custom-fields: add Custom Fields and Custom Values CRUD (#101) (6ed53f1)
- documents: add Documents, Document Types, and Document Folders (#102) (0b284b9)
- error: extract structured Humaans API error fields (#88) (dfeb97a)
- esign: add Esign family read-only resources (#113) (6fa3e2e)
- http_client: pass-through req_options on Humaans.new/1 (#89) (48f9c59)
- http_client: retry transient failures with bounded backoff (#90) (158d960)
- me, token_info: add singleton helpers for /me and /token-info (#96) (89dea03)
- org-structure: add Job Roles, Locations, and Spaces (#103) (50140e4)
- performance: add Performance family read-only resources (#108) (cb4b1cd)
- profile-family: add D2 employee profile resources (#106) (7c3324b)
- query: add chainable filter query builder (#93) (3b25f52)
- requests-workflow: add Requests and Workflow family read-only resources (#112) (69acd3e)
- time-away: add Time Away family CRUD resources (#100) (ce059f2)
- webhooks: add HMAC-SHA256 signature verification helper (#92) (9cd0c7e)
- webhooks: add Webhooks CRUD (#105) (6d26a0f)
- working-patterns: add Working Patterns and Allocations CRUD (#104) (1d91eda)
Bug Fixes
- deps: bump req from 0.5.17 to 0.5.18 (#114) (265ae46)
- deps: bump req from 0.5.18 to 0.6.1 (#119) (3ad4e01)
- deps: bump req from 0.6.1 to 0.6.2 (#121) (88e0e01)
- pagination: use $-prefixed limit/skip params (#86) (cb6f868)
Performance Improvements
0.5.1 (2026-04-22)
Bug Fixes
0.5.0 (2026-04-15)
Features
- add Humaans.Pagination for page-by-page and streaming iteration (#77) (36b8955)
- add telemetry instrumentation for API requests (#75) (048be7d)
- introduce Humaans.Error for structured error handling (#72) (a60d780)
- parse ISO 8601 date and datetime strings into native Elixir types (#74) (f3b461e)
0.4.2 (2026-04-14)
Bug Fixes
0.4.1 - 2025-04-25
Changes
-Fixed incorrect encoding of request body for HTTP patch, post and put methods.
0.4.0 - 2025-03-11
Changed
- Configurable HTTP client module
- Updated and improved package and module documentation
0.3.1 - 2025-03-04
Changed
- Fixed existing release notes
- Updated package release workflow
0.3.0 - 2025-03-04
Changes
- Introduce
ResponseHandlerto centrally manage how API responses are handled.
0.2.2 - 2025-03-04
Enhancements
- Improved ExDoc configuration for HexDocs
- Added changelog to package metadata for Hex.pm
0.2.1 - 2025-03-04
Changed
- Provide default implementation for Humaans.Client.
0.2.0 - 2025-03-03
Changed
- Breaking change: Switched to a client-based approach instead of global configuration
- Added convenience accessor functions for resource modules
Usage changes
Instead of using global configuration:
{:ok, people} = Humaans.People.list()Now use the client-based approach:
client = Humaans.new(access_token: "YOUR_ACCESS_TOKEN")
{:ok, people} = Humaans.People.list(client)0.1.0 - 2025-02-26
Initial release. :rocket: