Custom Provider Versions

Versions represent different releases of a custom provider. Each version can be deployed to environments.

Custom Provider Versions object

Attributes

object

String

String representing the object's type

id

String

Unique custom provider version identifier

status

Enum

Current version status

config

ObjectNullable

index

Number

Version index number

identifier

String

Version identifier

deployment

Object

environments

Object

Environments this version is deployed to

custom_provider_id

String

ID of the parent custom provider

provider_id

StringNullable

ID of the associated provider

actor

Object

container_image

ObjectOptional

remote_mcp_server

ObjectOptional

created_at

Date

Timestamp when created

updated_at

Date

Timestamp when last updated

{
  "object": "custom_provider.version",
  "id": "cpv_1aBcDeFgHjKlMnPq",
  "status": "queued",
  "config": {
    "object": "custom_provider.version.config",
    "schema": {
      "type": "json_schema",
      "schema": {}
    }
  },
  "index": 1,
  "identifier": "v1.0.0",
  "deployment": {
    "object": "custom_provider.deployment",
    "id": "cpd_1aBcDeFgHjKlMnPq",
    "status": "failed",
    "trigger": "manual",
    "custom_provider_id": "cpr_1aBcDeFgHjKlMnPq",
    "provider_id": "pro_5gHjKlMnPqRsTuVw",
    "custom_provider_version_id": "cpv_1aBcDeFgHjKlMnPq",
    "commit": {
      "object": "custom_provider.deployment.commit",
      "type": "create_version"
    },
    "immutable_bucket": {
      "object": "bucket",
      "scm_repo_link": {
        "object": "bucket.scm_repo",
        "is_linked": true,
        "repository": {
          "object": "scm.repository",
          "provider": {
            "object": "scm.provider",
            "type": "github"
          }
        }
      }
    },
    "actor": {
      "object": "custom_provider.actor#preview",
      "id": "act_1aBcDeFgHjKlMnPq",
      "type": "external",
      "identifier": "mtea-orgact_1aBcDeFgHjKlMnPq",
      "name": "John Doe",
      "organization_actor_id": "ora_1aBcDeFgHjKlMnPq",
      "created_at": "2025-09-15T10:30:00.000Z"
    },
    "scm_push": {
      "object": "scm.push",
      "actor": {
        "object": "scm.actor"
      },
      "commit": {
        "object": "scm.commit"
      },
      "repository": {
        "object": "scm.repository",
        "provider": {
          "object": "scm.provider",
          "type": "github"
        }
      }
    },
    "created_at": "2025-09-15T10:30:00.000Z",
    "updated_at": "2026-01-10T14:45:00.000Z"
  },
  "environments": [
    {
      "object": "custom_provider.environment",
      "id": "cpenv_1aBcDeFgHjKlMnPq",
      "environment": {
        "object": "custom_provider.environment",
        "id": "cpenv_1aBcDeFgHjKlMnPq",
        "custom_provider_id": "cpr_1aBcDeFgHjKlMnPq",
        "provider_id": "pro_5gHjKlMnPqRsTuVw",
        "current_provider_version_id": "prv_4dEfGhJkLmNpQrSt",
        "instance_id": "ins_2cDeFgHjKlMnPqRs",
        "created_at": "2025-09-15T10:30:00.000Z",
        "updated_at": "2026-01-10T14:45:00.000Z"
      }
    },
    {
      "object": "custom_provider.environment",
      "id": "cpenv_1aBcDeFgHjKlMnPq",
      "environment": {
        "object": "custom_provider.environment",
        "id": "cpenv_1aBcDeFgHjKlMnPq",
        "custom_provider_id": "cpr_1aBcDeFgHjKlMnPq",
        "provider_id": "pro_5gHjKlMnPqRsTuVw",
        "current_provider_version_id": "prv_4dEfGhJkLmNpQrSt",
        "instance_id": "ins_2cDeFgHjKlMnPqRs",
        "created_at": "2025-09-15T10:30:00.000Z",
        "updated_at": "2026-01-10T14:45:00.000Z"
      }
    }
  ],
  "custom_provider_id": "cpr_1aBcDeFgHjKlMnPq",
  "provider_id": "pro_5gHjKlMnPqRsTuVw",
  "actor": {
    "object": "custom_provider.actor#preview",
    "id": "act_1aBcDeFgHjKlMnPq",
    "type": "external",
    "identifier": "mtea-orgact_1aBcDeFgHjKlMnPq",
    "name": "John Doe",
    "organization_actor_id": "ora_1aBcDeFgHjKlMnPq",
    "created_at": "2025-09-15T10:30:00.000Z"
  },
  "container_image": {
    "container_registry": "https://index.docker.io/v1/",
    "container_image_tag": "v1.0.0",
    "container_image": "my-app-image"
  },
  "remote_mcp_server": {
    "url": "https://mcp.example.com",
    "transport": "grpc"
  },
  "created_at": "2025-09-15T10:30:00.000Z",
  "updated_at": "2026-01-10T14:45:00.000Z"
}

List custom provider versions

Returns a paginated list of versions for a custom provider.

Query Parameters

limit

NumberOptional

after

StringOptional

before

StringOptional

cursor

StringOptional

order

EnumOptional

status

UnionOptional

Filter by deployment status

id

UnionOptional

Filter by version ID(s)

provider_id

UnionOptional

Filter by provider IDs (matches providers connected to sessions)

provider_version_id

UnionOptional

Filter by provider version IDs (matches providers connected to sessions)

custom_provider_id

UnionOptional

Filter by custom provider IDs (matches providers connected to sessions)

custom_provider_deployment_id

UnionOptional

Filter by custom provider deployment IDs (matches providers connected to sessions)

custom_provider_environment_id

UnionOptional

Filter by custom provider environment IDs (matches providers connected to sessions)

created_at

ObjectOptional

Filter custom provider version creation time by date range

updated_at

ObjectOptional

Filter custom provider version last update time by date range

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

Get custom provider version

Retrieves a specific version of a custom provider.

URL Parameters

custom_provider_version_id

String

The unique identifier for the custom_provider_version

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

Create custom provider version

Creates a new version for a custom provider.

Request Body

custom_provider_id

String

Custom provider ID

from

Object

config

ObjectOptional
POSThttp://api.metorial.com/custom-provider-versions
curl -X POST "https://api.metorial.com/custom-provider-versions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "custom_provider_id": "example_custom_provider_id",
  "from": {
    "type": "example_type",
    "image_ref": "example_image_ref",
    "username": "example_username",
    "password": "example_password"
  },
  "config": {
    "schema": {},
    "transformer": "example_transformer"
  }
}'