typed_providers_list

List typed provider lifecycle catalogs and registered versions.

Key notes

• Requires tenant_id and namespace_id scope fields.
• Supports deterministic pagination via cursor + limit.
• Results are scoped by provider discovery disclosure policy.

Inputs

• cursor (optional): One of 2 schema variants.
• limit (optional): Maximum number of provider catalogs to return.
• namespace_id (required): Namespace identifier.
• tenant_id (required): Tenant identifier.

Input Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "cursor": {
      "oneOf": [
        {
          "type": "null"
        },
        {
          "description": "Pagination cursor.",
          "type": "string"
        }
      ]
    },
    "limit": {
      "description": "Maximum number of provider catalogs to return.",
      "maximum": 1000,
      "minimum": 1,
      "type": "integer"
    },
    "namespace_id": {
      "description": "Namespace identifier.",
      "minimum": 1,
      "type": "integer"
    },
    "tenant_id": {
      "description": "Tenant identifier.",
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "tenant_id",
    "namespace_id"
  ],
  "type": "object"
}

Outputs

• items (required): Type: array.
• next_token (required): One of 2 schema variants.

Output Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "items": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "active_version": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "description": "Current active lifecycle version.",
                "type": "string"
              }
            ]
          },
          "provider_id": {
            "description": "Typed provider identifier.",
            "type": "string"
          },
          "versions": {
            "items": {
              "additionalProperties": false,
              "properties": {
                "deprecated": {
                  "description": "Whether this lifecycle version is deprecated.",
                  "type": "boolean"
                },
                "profile_digest": {
                  "additionalProperties": false,
                  "properties": {
                    "algorithm": {
                      "enum": [
                        "sha256"
                      ],
                      "type": "string"
                    },
                    "value": {
                      "description": "Lowercase hex digest.",
                      "type": "string"
                    }
                  },
                  "required": [
                    "algorithm",
                    "value"
                  ],
                  "type": "object"
                },
                "source_digest": {
                  "additionalProperties": false,
                  "properties": {
                    "algorithm": {
                      "enum": [
                        "sha256"
                      ],
                      "type": "string"
                    },
                    "value": {
                      "description": "Lowercase hex digest.",
                      "type": "string"
                    }
                  },
                  "required": [
                    "algorithm",
                    "value"
                  ],
                  "type": "object"
                },
                "version": {
                  "description": "Lifecycle version identifier.",
                  "type": "string"
                }
              },
              "required": [
                "version",
                "deprecated",
                "source_digest",
                "profile_digest"
              ],
              "type": "object"
            },
            "type": "array"
          }
        },
        "required": [
          "provider_id",
          "active_version",
          "versions"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "next_token": {
      "oneOf": [
        {
          "type": "null"
        },
        {
          "description": "Pagination token for the next page.",
          "type": "string"
        }
      ]
    }
  },
  "required": [
    "items",
    "next_token"
  ],
  "type": "object"
}

Examples

List typed provider lifecycle catalogs.

Input:

{
  "cursor": null,
  "limit": 50,
  "namespace_id": 1,
  "tenant_id": 1
}

Output:

{
  "items": [
    {
      "active_version": "2026-02-17.1",
      "provider_id": "asset_api",
      "versions": [
        {
          "deprecated": false,
          "profile_digest": {
            "algorithm": "sha256",
            "value": "5c3a5b6bce0f4a2c9e22c4fa6a1e6d8d90b0f2dfed1b7f1e9b3d3b3d1f0c9b21"
          },
          "source_digest": {
            "algorithm": "sha256",
            "value": "5c3a5b6bce0f4a2c9e22c4fa6a1e6d8d90b0f2dfed1b7f1e9b3d3b3d1f0c9b21"
          },
          "version": "2026-02-17.1"
        }
      ]
    }
  ],
  "next_token": null
}