MetorialDocs

Provider Versions

A version is a specific release of a provider (e.g., v1.2.0). Each version has its own tools, auth methods, and config schema. Deployments are pinned to a version for security reasons.

The Provider Version object

provider_version.json
{
  "object": "provider.version",
  "id": "prv_4dEfGhJkLmNpQrSt",
  "version": "1.0.0",
  "provider_id": "pro_5gHjKlMnPqRsTuVw",
  "is_current": false,
  "name": "Version 1.0.0",
  "description": "example_description",
  "metadata": {},
  "specification_id": "psp_9gHjKlMnPqRsTuVw",
  "created_at": "2025-09-15T10:30:00.000Z",
  "updated_at": "2026-01-10T14:45:00.000Z"
}
object"provider.version"required
idstringrequired
versionstringrequired
provider_idstringrequired
is_currentbooleanrequired
namestringrequired
descriptionstringrequirednullable
metadataRecord<string, any>requirednullable
specification_idstringrequirednullable
created_atdaterequired
updated_atdaterequired

Endpoints

List provider versions

GET/provider-versions

Returns a paginated list of provider versions.

Query parameters

idstring or string[]optional

Filter by version ID(s)

provider_idstring or string[]optional

Filter by provider ID(s)

Example request

curl -X GET "https://api.metorial.com/provider-versions" \
  -H "Authorization: Bearer metorial_sk_io2h4..."

Get provider version

GET/provider-versions/:provider_version_id

Retrieves a specific provider version by ID.

Path parameters

provider_version_idstringrequired

The unique identifier for the provider_version

Example request

curl -X GET "https://api.metorial.com/provider-versions/pro_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_io2h4..."