Get breaking changes of a provider
get_provider_changesRead-only
Returns what the page of one provider, tool or module shows: the range of releases that is tracked, the summary sentence, the notices and the breaking changes of each release that lists any. Send from with the version in use to get only the releases above it. Read the notices before you call a range clear: they say which releases were not tracked or whose release notes were not read.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"provider": "<provider>"
},
"name": "get_provider_changes"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| from | No | The version in use, or a version constraint, of at most 64 characters. Only releases newer than that version are in the answer. For a constraint, that version is the lowest one the constraint allows. Leave it out for every tracked release whose release notes were read and list a breaking change. | |
| provider | Yes | Key of the provider, tool or module, as in the key field of list_providers. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| key | Yes | Key of the entry: the provider key (for example azurerm) or the name of the module. It is the last part of its page address. | |
| url | Yes | Page of the entry on the site. | |
| from | Yes | The version in use that the answer starts from, as plain semver. For a constraint it is the lowest version the constraint allows. Only newer releases are in the answer. Null when no version was given or when the value sent is not a version or a constraint. | |
| kind | Yes | What the entry is: a Terraform provider, a tool or language, or a module. | |
| name | Yes | Display name of the entry. | |
| as_of | Yes | The UTC day (YYYY-MM-DD) every value that depends on the day was counted for. | |
| cloud | Yes | Cloud the entry belongs to. | |
| state | Yes | How the answer was chosen. all: no version was given, so every tracked release whose release notes were read and list a breaking change is in it. range: the tracked releases newer than from whose release notes were read and list a breaking change are in it. clear: from is not older than the oldest tracked release, the release notes of every tracked release newer than from were read, and none lists one. partial: among the tracked releases newer than from whose release notes were read, none lists one, but part of the range was not read: from is older than the oldest tracked release, or the release notes of a tracked release newer than from were not read. Such a range is not clear. invalid: the value sent as from is not a version or a constraint, so the answer is the same as for all. In every state, read the notices before you call a range clear. | |
| notices | Yes | The sentences that go with the summary: a range that reaches below the oldest tracked release and versions whose release notes were not read, both word for word from the page, and a from value that could not be read. Empty when the summary stands on its own. | |
| subject | Yes | What a module deploys, as the Azure Verified Modules index names it. Null for providers and tools. | |
| summary | Yes | The summary sentence of the page for this answer. | |
| json_url | Yes | The same page as JSON. | |
| releases | Yes | The releases in the answered range whose release notes were read and list a breaking change, newest first. | |
| repo_url | Yes | The GitHub repository whose releases are read. | |
| namespace | Yes | Where the entry is published: its address in the Terraform Registry, or its GitHub repository when it is not in the registry. | |
| short_url | Yes | Short address of the page for this answer. It redirects to url. | |
| latest_date | Yes | Day that release was published (YYYY-MM-DD), or null when it is not known. | |
| markdown_url | Yes | The same page as Markdown. | |
| registry_url | Yes | Page of a module in the Terraform Registry. Null for providers and tools. | |
| counted_since | Yes | Set when the tracked releases start less than twelve months before the as_of day: the oldest tracked version, where that count really starts. Null otherwise. | |
| latest_version | Yes | The newest tracked stable release, without a leading v. Null when none is loaded. | |
| unread_versions | Yes | The versions in the answered range whose release notes were not read, newest first. Nothing is known about breaking changes in them, and they are not in releases. | |
| latest_confirmed | Yes | True when the tracked list holds every stable release from oldest_tracked_version on, so latest_version is the latest stable release. False when it is only the newest release tracked here: a newer one may exist. | |
| latest_notes_read | Yes | False when the newest release is known from the Terraform Registry only and has no GitHub release: its release notes were not read. Null when no release is loaded. | |
| oldest_tracked_version | Yes | The oldest tracked stable release. Releases before it were not read. Null when none is loaded. | |
| breaking_releases_last_12_months | Yes | Number of tracked stable releases published in the twelve months up to the as_of day whose release notes were read and list at least one breaking change. |