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

  • pagination: default page size to 100 (#87) (2dfb053)

0.5.1 (2026-04-22)

Bug Fixes

  • deps: update telemetry from 1.3.0 to 1.4.1, credo to 1.7.18 (#83) (0184955)

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

  • ci: Disable credo check on API response struct (#56) (85c1c76)

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 ResponseHandler to 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: