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.

Provider Versions object

Attributes

object

String

String representing the object's type

id

String

Unique version identifier

version

String

Version identifier string

provider_id

String

Provider ID

is_current

Boolean

Whether this is the current version

name

String

Version name

description

StringNullable

Version description

metadata

ObjectNullable

Custom key-value pairs for storing additional information

specification_id

StringNullable

Specification ID

created_at

Date

Timestamp when created

updated_at

Date

Timestamp when last updated

{
  "object": "provider.version",
  "id": "prv_4dEfGhJkLmNpQrSt",
  "version": "1.0.0",
  "provider_id": "pro_5gHjKlMnPqRsTuVw",
  "name": "Version 1.0.0",
  "metadata": {
    "imported_from": "legacy-system",
    "migration_date": "2025-09-01"
  },
  "specification_id": "psp_9gHjKlMnPqRsTuVw",
  "created_at": "2025-09-15T10:30:00.000Z",
  "updated_at": "2026-01-10T14:45:00.000Z"
}

List provider versions

Returns a paginated list of provider versions.

Query Parameters

limit

NumberOptional

Maximum number of items to return (1-100)

after

StringOptional

Return items after this ID

before

StringOptional

Return items before this ID

cursor

StringOptional

Pagination cursor from a previous response

order

EnumOptional

Sort order for results

id

UnionOptional

Filter by version ID(s)

provider_id

UnionOptional

Filter by provider ID(s)

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

Get provider version

Retrieves a specific provider version by ID.

URL Parameters

provider_version_id

String

The unique identifier for the provider_version

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