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

• API Versioning
• nself api CLI reference