Skip to main content

Deprecation Registry API

GET /api/deprecation-registry.json, public plugin API version and deprecation registry

GET https://ping.nself.org/api/deprecation-registry.json

Returns the current plugin API version and deprecation state for all ɳSelf plugins. No authentication required.

Response

{
  "schema_version": "1",
  "generated_at": "2026-04-23T00:00:00Z",
  "lts_baseline": "1.0.9",
  "lts_window_end": "2027-04-17",
  "plugins": [
    {
      "name": "ai",
      "api_version": "1.3.0",
      "deprecated_endpoints": []
    },
    {
      "name": "auth",
      "api_version": "1.1.0",
      "deprecated_endpoints": []
    }
  ]
}

Fields

Field Type Description
schema_version string Registry format version (currently "1")
generated_at string ISO 8601 UTC timestamp of registry generation
lts_baseline string nself version that established this support baseline
lts_window_end string Date (ISO 8601) when the support window closes
plugins[].name string Plugin name (matches plugin.json name field)
plugins[].api_version string Current SemVer of the plugin’s HTTP API
plugins[].deprecated_endpoints array List of deprecated endpoint entries (empty at v1.1.0 baseline)

Deprecated Endpoint Object

When deprecated_endpoints is non-empty:

{
  "path": "/v1/complete",
  "deprecated_in": "1.2.0",
  "removed_in": "2.0.0",
  "replacement": "/v2/complete",
  "reason": "Unified completion API with streaming support",
  "sunset_header": "Sat, 01 Jan 2027 00:00:00 GMT"
}
Field Type Description
path string HTTP path of the deprecated endpoint
deprecated_in string Plugin API version when the endpoint was deprecated
removed_in string Plugin API version when the endpoint will be removed
replacement string Path or description of the replacement
reason string Human-readable rationale
sunset_header string RFC-1123 UTC date for the Sunset HTTP header

Caching

The response is served with Cache-Control: no-store. Fetch fresh for CI checks. For long-lived consumers, cache locally with a TTL of your choice.

See Also