MEmetorial
Custom Providers

List custom providers

Returns a paginated list of custom providers.

get/custom-providers

Request

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

Query parameters

limitnumber
afterstring
beforestring
cursorstring
order'asc' | 'desc'
'active' | 'archived'
OR
string[]

Filter by status (active, archived)

'container' | 'function' | 'remote'
OR
string[]

Filter by type (container, function, remote)

string
OR
string[]

Filter by custom provider IDs

string
OR
string[]

Filter by provider IDs (matches providers connected to sessions)

searchstring

Search by name or description

gtstring date-time

Only include records after this timestamp for custom provider creation time

ltstring date-time

Only include records before this timestamp for custom provider creation time

Filter custom provider creation time by date range

gtstring date-time

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

ltstring date-time

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

Filter custom provider 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": "cpr_1aBcDeFgHjKlMnPq",
      "name": "My Custom Provider",
      "description": "A custom provider for my application",
      "draft": {
        "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"
        }
      },
      "provider": {
        "id": "pro_5gHjKlMnPqRsTuVw",
        "publisher": {
          "id": "pub_9hJkLmNpQrStUvWx",
          "name": "Acme Corp",
          "description": "A leading provider of developer tools",
          "image_url": "https://cdn.metorial.com/images/acme.png",
          "created_at": "2025-09-15T10:30:00.000Z",
          "updated_at": "2026-01-10T14:45:00.000Z"
        },
        "current_version": {
          "id": "prv_4dEfGhJkLmNpQrSt",
          "version": "1.0.0",
          "provider_id": "pro_5gHjKlMnPqRsTuVw",
          "name": "Version 1.0.0",
          "specification_id": "psp_9gHjKlMnPqRsTuVw",
          "created_at": "2025-09-15T10:30:00.000Z",
          "updated_at": "2026-01-10T14:45:00.000Z"
        },
        "created_at": "2025-09-15T10:30:00.000Z",
        "updated_at": "2026-01-10T14:45:00.000Z"
      },
      "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.