typed_providers_deprecate

Deprecate a typed provider lifecycle version, with optional active rollback.

Key notes

• Requires tenant_id and namespace_id scope fields.
• Deprecating the active version requires explicit rollback_if_active=true.
• Rollback selects the most recent non-deprecated prior active version.

Inputs

• namespace_id (required): Namespace identifier.
• provider_id (required): Typed provider identifier.
• rollback_if_active (optional): Rollback active version before deprecating when required.
• tenant_id (required): Tenant identifier.
• version (required): Lifecycle version to deprecate.

Input Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "namespace_id": {
      "description": "Namespace identifier.",
      "minimum": 1,
      "type": "integer"
    },
    "provider_id": {
      "description": "Typed provider identifier.",
      "type": "string"
    },
    "rollback_if_active": {
      "description": "Rollback active version before deprecating when required.",
      "type": "boolean"
    },
    "tenant_id": {
      "description": "Tenant identifier.",
      "minimum": 1,
      "type": "integer"
    },
    "version": {
      "description": "Lifecycle version to deprecate.",
      "type": "string"
    }
  },
  "required": [
    "tenant_id",
    "namespace_id",
    "provider_id",
    "version"
  ],
  "type": "object"
}

Outputs

• active_version (required): One of 2 schema variants.
• deprecated_version (required): Deprecated lifecycle version.
• provider_id (required): Typed provider identifier.
• rolled_back_from (required): One of 2 schema variants.

Output Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "active_version": {
      "oneOf": [
        {
          "type": "null"
        },
        {
          "description": "Current active version after deprecation.",
          "type": "string"
        }
      ]
    },
    "deprecated_version": {
      "description": "Deprecated lifecycle version.",
      "type": "string"
    },
    "provider_id": {
      "description": "Typed provider identifier.",
      "type": "string"
    },
    "rolled_back_from": {
      "oneOf": [
        {
          "type": "null"
        },
        {
          "description": "Former active version when rollback occurred.",
          "type": "string"
        }
      ]
    }
  },
  "required": [
    "provider_id",
    "deprecated_version",
    "active_version",
    "rolled_back_from"
  ],
  "type": "object"
}

Examples

Deprecate a typed provider version with rollback.

Input:

{
  "namespace_id": 1,
  "provider_id": "asset_api",
  "rollback_if_active": true,
  "tenant_id": 1,
  "version": "2026-02-17.2"
}

Output:

{
  "active_version": "2026-02-17.1",
  "deprecated_version": "2026-02-17.2",
  "provider_id": "asset_api",
  "rolled_back_from": "2026-02-17.2"
}