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

Semantic version string

status

String

Version status (released, draft, deprecated)

created_at

Date

Timestamp when created

updated_at

Date

Timestamp when last updated

{
  "object": "provider.version",
  "id": "prv_4dEfGhJkLmNpQrSt",
  "version": "1.0.0",
  "status": "released",
  "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.

URL Parameters

provider_id

String

The unique identifier for the provider

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

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

Get provider version

Retrieves a specific provider version by ID.

URL Parameters

provider_id

String

The unique identifier for the provider

provider_version_id

String

The unique identifier for the provider_version

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