MEmetorial
Custom Provider Versions

Get custom provider version

Retrieves a specific version of a custom provider.

get/custom-provider-versions/{custom_provider_version_id}

Request

  • Base URL
    https://api.metorial.com
  • Auth
    HTTP bearer

Path parameters

custom_provider_version_idstring required

Unique identifier of the custom provider version.

Headers

Metorial-Versionstring
Example:2025-01-01

Pin the dated API version for this request, e.g. 2025-01-01. Defaults to the version configured for the environment.

Response

Successful response

object'custom_provider.version' required

String representing the object's type

idstring required

Unique custom provider version identifier

status'queued' | 'deploying' | 'deployment_succeeded' | 'deployment_failed' required

Current version status

indexnumber required

Version index number

identifierstring required

Version identifier

custom_provider_idstring required

ID of the parent custom provider

provider_idstring nullable required

ID of the associated provider

created_atstring date-time required

Timestamp when created

updated_atstring date-time required

Timestamp when last updated

Example response

{
  "id": "cpv_1aBcDeFgHjKlMnPq",
  "index": 1,
  "identifier": "v1.0.0",
  "deployment": {
    "id": "cpd_1aBcDeFgHjKlMnPq",
    "custom_provider_id": "cpr_1aBcDeFgHjKlMnPq",
    "provider_id": "pro_5gHjKlMnPqRsTuVw",
    "custom_provider_version_id": "cpv_1aBcDeFgHjKlMnPq",
    "actor": {
      "id": "act_1aBcDeFgHjKlMnPq",
      "identifier": "mtea-orgact_1aBcDeFgHjKlMnPq",
      "name": "John Doe",
      "organization_actor_id": "ora_1aBcDeFgHjKlMnPq",
      "created_at": "2025-09-15T10:30:00.000Z"
    },
    "created_at": "2025-09-15T10:30:00.000Z",
    "updated_at": "2026-01-10T14:45:00.000Z"
  },
  "environments": [
    {
      "id": "cpenv_1aBcDeFgHjKlMnPq",
      "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": {
    "id": "act_1aBcDeFgHjKlMnPq",
    "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"
}

Changes

No recorded changes to this operation across all 1 revision of this API.