Dosu API Versioning and Sunset Policy

Dosu's newest Public API endpoints are served under versioned paths such as /v1. Many endpoints are still served unversioned; both are covered by the deprecation policy below. New endpoints, optional fields, and backwards-compatible behavior changes are added within the current version. Breaking changes are introduced in a new version or behind a new endpoint.

Deprecation policy

When Dosu deprecates a public API field, endpoint, authentication method, or MCP behavior, the replacement path and the planned sunset date are documented before the old behavior is removed. Deprecated public API behavior remains available for at least 180 days after the published deprecation notice unless a security or abuse issue requires faster action.

Sunset notices

A sunset notice includes:

• The affected API version, endpoint, field, or behavior.
• The replacement API or migration path.
• The deprecation date and sunset date.
• Any required authentication, scope, or permission changes.

For APIs with known client usage, Dosu may also notify organization owners or administrators directly and may include standard deprecation or sunset metadata in API responses.

Current version

The current versioned Public API is v1. The machine-readable OpenAPI specification is available at https://api.dosu.dev/openapi.json.