Platform updates
A full history of API versions, new capabilities, breaking changes, and deprecations. Breaking changes are always announced at least 90 days in advance.
April 1, 2026
v1.4.0
MinorNew
- Webhook signature verification — all webhook payloads now include a
Ventryx-Signatureheader for HMAC-SHA256 validation. - Workflow run history endpoint:
GET /workflows/:id/runsreturns a paginated log of all executions. - Event filtering —
GET /eventsnow supportstype,from, andtoquery parameters.
Improved
- API key creation now returns the full key object including all assigned scopes.
- Rate limit headers are now returned on all
429responses with aRetry-Aftervalue.
February 14, 2026
v1.3.0
MinorNew
- Approval flows — workflows now support a
require_approvalstep type with configurable approvers and timeout. - Multi-step workflows — workflows can now define sequential and parallel step chains.
- Organization-level usage analytics endpoint:
GET /analytics/usage.
Fixed
- Resolved an issue where
PATCH /workflows/:iddid not correctly merge nested step configurations. - Event timestamps now consistently return ISO 8601 format with millisecond precision.
December 10, 2025
v1.2.0
MinorNew
- Scoped API keys — keys can now be issued with granular
resource:actionscopes. - Test environment — all accounts now have a sandboxed test environment accessible via
vtx_test_*keys.
Improved
- Error responses now include a machine-readable
codefield alongside the human-readablemessage. - Pagination
metaobject now includestotal,page, andper_pageon all list endpoints.
October 1, 2025
v1.0.0
MajorInitial release
- Ventryx REST API v1 publicly available.
- Workflows: create, retrieve, update, delete.
- Events: emit and retrieve.
- API key management: create and revoke.
- Organization model with role-based access.
- Official Node.js and Python SDKs.