Weaviate Deprecation Structure

{
  "$schema": "https://json-structure.org/meta/extended/v0/#",
  "$id": "https://api-evangelist.github.io/weaviate/json-structure/weaviate-deprecation-structure.json",
  "title": "Deprecation",
  "description": "Weaviate Deprecation schema",
  "type": "object",
  "properties": {
    "id": {
      "type": "str",
      "description": "The id that uniquely identifies this particular deprecation (mostly used internally)."
    },
    "status": {
      "type": "str",
      "description": "Whether the problematic API functionality is deprecated (planned to be removed) or already removed."
    },
    "apiType": {
      "type": "str",
      "description": "Describes which API is affected, usually one of: REST, GraphQL and gRPC."
    },
    "msg": {
      "type": "str",
      "description": "What this deprecation is about."
    },
    "mitigation": {
      "type": "str",
      "description": "User-required object to not be affected by the (planned) removal."
    },
    "sinceVersion": {
      "type": "str",
      "description": "The deprecation was introduced in this version."
    },
    "plannedRemovalVersion": {
      "type": "str",
      "description": "A best-effort guess of which upcoming version will remove the feature entirely."
    },
    "removedIn": {
      "type": "str",
      "description": "If the feature has already been removed, it was removed in this version."
    },
    "removedTime": {
      "type": "datetime",
      "description": "If the feature has already been removed, it was removed at this timestamp."
    },
    "sinceTime": {
      "type": "datetime",
      "description": "The deprecation was introduced at this timestamp."
    },
    "locations": {
      "type": "array",
      "description": "The locations within the specified API affected by this deprecation."
    }
  }
}