MEmetorial
Custom Provider Versions

List custom provider versions

Returns a paginated list of versions for a custom provider.

get/custom-provider-versions

Request

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

Query parameters

limitnumber
afterstring
beforestring
cursorstring
order'asc' | 'desc'
'queued' | 'deploying' | 'deployment_succeeded' | 'deployment_failed'
OR
string[]

Filter by deployment status

string
OR
string[]

Filter by version ID(s)

string
OR
string[]

Filter by provider IDs (matches providers connected to sessions)

string
OR
string[]

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

string
OR
string[]

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

string
OR
string[]

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

string
OR
string[]

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

gtstring date-time

Only include records after this timestamp for custom provider version creation time

ltstring date-time

Only include records before this timestamp for custom provider version creation time

Filter custom provider version creation time by date range

gtstring date-time

Only include records after this timestamp for custom provider version last update time

ltstring date-time

Only include records before this timestamp for custom provider version last update time

Filter custom provider version last update time by date range

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

Example response

{
  "items": [
    {
      "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.