Developer documentation

BLERBZ API Versioning

Version support, migration guidance, and breaking-change policy for BLERBZ APIs.

Developer portalOpenAPIAgentsMCP

Current Version

The current public developer contract is NUCLEUZ API v2 for ranked feeds, documents, search, sync, batch, sandbox status, and agent integration. Older v1 job-pattern examples are compatibility scaffolds where documented.

Support Window

BLERBZ aims to support public API versions for at least 12 months after a successor version is documented, unless a security, legal, or abuse-prevention issue requires faster remediation.

Notification

When an API version is deprecated, BLERBZ may use Deprecation, Sunset, and Link headers with rel="deprecation", rel="sunset", and rel="successor-version", plus documentation updates on the developer portal.

Breaking Changes

Breaking changes should be avoided on stable v2 endpoints. Additive fields, new optional parameters, and new resources are preferred. If a breaking change is required, migration guidance will be published before the sunset date where feasible.