API v2 & SDK Updates
After several months in beta, the TaskForge API v2 is now generally available. This release represents a significant step forward in developer experience, with a cleaner resource model, more predictable error handling, and expanded filtering and pagination support.
Redesigned resource model
API v2 introduces a unified resource hierarchy that aligns more closely with how teams actually use the platform. Tasks, pipelines, models, and datasets are now first-class resources with consistent CRUD endpoints, relationship traversal, and bulk operation support.
- Consistent endpoint structure across all resource types
- Relationship expansion via the
includequery parameter - Bulk create, update, and delete endpoints for all resources
- Cursor-based pagination for large result sets
Improved error responses
Error responses in v2 follow the RFC 9457 Problem Details standard, providing machine-readable error codes, human-readable descriptions, and contextual metadata for each failure case. This makes client-side error handling significantly more reliable.
Updated SDKs
Official SDKs for Python, Node.js, and Go have been updated to target API v2. All SDKs are fully typed, include comprehensive documentation, and ship with built-in retry logic, authentication helpers, and pagination utilities. The v1 API remains supported until Q3 2026.
Migration guide
A detailed migration guide from v1 to v2 is available in the documentation. The primary breaking changes involve renamed resource fields and updated authentication header format. A compatibility shim is available for teams that need more time to migrate.
