Skip to content
Connect an agent

Health

List the versions of the Terraform and OpenTofu provider

Every version of plotwork-official/plotwork the Terraform Registry lists, newest first, each with its channel (beta for a pre-release) and when it was published, and latest, the newest stable version (the newest beta while no stable version exists).

GET/meta/terraform-provider/versions

TL;DR

QuestionAnswer
What does it do?List the versions of the Terraform and OpenTofu provider.
What does it take?Nothing.
What does it return?Status 200 with a body of type ProviderVersions.
What can go wrong?429 too many requests. Every failure uses the one error envelope.

What it does

Every version of plotwork-official/plotwork the Terraform Registry lists, newest first, each with its channel (beta for a pre-release) and when it was published, and latest, the newest stable version (the newest beta while no stable version exists). The Registry is read at most once every ten minutes; when it cannot be read the answer is the release this build was made with, with source fallback. Only versions, dates and channels are answered. Public and cacheable for ten minutes.

Responses

StatusMeaningBody
200The versions, newest first.ProviderVersions
429Too many requests.ErrorResponse

Response body

A 200 answer has the type ProviderVersions.

FieldTypeRequiredDescription
source"registry" | "fallback"yesregistry when the list is the Terraform Registry's; fallback when the Registry could not be read and the list is the one release this build was made with.
lateststringyesThe newest stable version, or the newest beta while no stable version exists. at most 64 characters.
itemsProviderVersion[]yesEvery version the Registry lists, newest first, at most 100.
items[].versionstringyesThe version, as required_providers names it. at most 64 characters.
items[].channel"stable" | "beta"yesbeta for a pre-release (a version with a suffix such as -beta.3), which a version range never picks; stable otherwise.
items[].publishedAtstring | nullyesWhen the Registry published it, as an ISO 8601 time, or null when that is not known (the committed fallback). at most 40 characters.

See also

DocWhy
API referenceEvery endpoint, and the error envelope
SchemasEvery request and response type
Tool referenceThe operations as callable tools