Product updates
Changelog
What changed in each dated version of the Humanos platform, newest first. The API is versioned by date — integrations pin a version with the API-Version header and upgrade on their own schedule, so a new version never changes behaviour you depend on until you opt in. Full technical detail lives in the API documentation.
2026-07-06 — Latest
Richer catalog and audit surfaces; leaner verification shapes.
- Actions: GET /actions and GET /actions/version/{id} now return the full catalog shape — action name and description, version list, per-version content, published flag and a digestSRI integrity hash, with standard pagination.
- Credentials: the credential entity gains name, description, tags and decisions.
- Verifiable presentations (breaking): issue/verify shapes simplified — the presentation response no longer nests presentationEncoded/receipt, and verification takes the presentation in its new form.
- Requests (breaking): the iframe object was removed from POST /request — iframe embedding is configured through the iframe integration guide instead.
- Subjects: extraContacts and identity handling refined on POST /user.
2026-06-18
Multi-user requests and a structured identity webhook.
- Multi-user requests (breaking): POST /request now takes a users[] array — each entry with its own contact, secondary contact, document id, language and signer quality.
- Embedding (breaking): iframe configuration moved into the request body; the top-level pubKey and redirectUrl fields were removed.
- Identity webhook (breaking): the flat identity payload became a structured document — addresses, birth, nationality, document type, issue date, expiry and more as first-class fields. Pin your webhook version before upgrading.
- Filtering: dateFrom/dateTo range filters normalised on GET /request and GET /activity.
2026-05-17
The platform surface: credentials, actions, DIDs, approvals, activity, webhooks.
- New endpoint groups: Credentials (evidence, issue VP, verify, revoke), Actions, DID resolution, Approvals (replacing Resources), Activity, and documented webhook event schemas.
- Idempotency: Idempotency-Key header support on POST /request, POST /user and PATCH /request/resend/{requestId} — safe retries without duplicate side effects.
- Lookups (breaking): users are addressed by id (previously did); request listing filters by subject.
2026-03-20
Initial public version.
- Requests: create, list, fetch, delete, and OTP resend.
- Users: create and look up.
- Credentials: fetch by id.
- Resources: list resources and resource groups (renamed to Approvals in 2026-05-17).
Staying informed
Breaking changes are only ever introduced behind a new dated version. Questions about an upgrade, or something behaving differently than these notes describe? Email support@humanos.tech and we will help you move across.