Version metadata

Endpoint

GET /api/content/:productSlug/version-metadata

Returns version metadata for a product. This includes the full list of available versions, their resolved version strings, and any version-to-version alias mappings. dev-portal uses this endpoint to populate version pickers and route version-specific content requests.

Path parameters

productSlug

string

required

The slug identifying the product.Examples: terraform-plugin-framework, terraform-enterprise, vault

Example requests

curl http://localhost:8080/api/content/terraform-plugin-framework/version-metadata

Response

Returns a JSON object with a result field containing the product’s version metadata.

200

{
  "result": [
    {
      "version": "v1.15.x",
      "isLatest": true
    },
    {
      "version": "v1.14.x",
      "isLatest": false
    },
    {
      "version": "v1.13.x",
      "isLatest": false
    }
  ]
}

Response fields

result

object[]

required

Array of version metadata objects, one per available version for the product.

Hide properties

version

string

The version string. For most products this is a semver-style string like v1.9.x. For Terraform Enterprise, it is a date-based string like v20220610-01.

isLatest

boolean

Whether this version is the current latest stable version. Only one version will have isLatest: true.

Error responses

Status	Body	Cause
`404`	`Not found`	The `productSlug` is not in the product configuration, or version metadata could not be resolved.

Endpoints

Endpoint

Path parameters

Example requests

Response

Response fields

Error responses

Build docs developers (and LLMs) love

Endpoints

​Endpoint

​Path parameters

​Example requests

​Response

​Response fields

​Error responses

Build docs developers (and LLMs) love

Endpoint

Path parameters

Example requests

Response

Response fields

Error responses