Custom Provider Commits

Commits represent version promotions between environments. Merge versions from one environment to another or rollback to a previous version.

Custom Provider Commits object

Attributes

object

String

String representing the object's type

id

String

Unique custom provider commit identifier

status

String

Current commit status

trigger

String

What triggered this commit

error

ObjectNullable

custom_provider_id

String

ID of the parent custom provider

provider_id

StringNullable

ID of the associated provider

custom_provider_deployment_id

StringNullable

ID of the associated deployment

to_environment

Object

from_environment

ObjectNullable

target_custom_provider_version

Object

previous_custom_provider_version

ObjectNullable

actor

Object

scm_push

ObjectNullable

created_at

Date

Timestamp when created

applied_at

DateNullable

Timestamp when the commit was applied

{
  "object": "custom_provider.commit",
  "id": "cpcm_1aBcDeFgHjKlMnPq",
  "status": "pending",
  "trigger": "manual",
  "error": {
    "code": "deployment_failed",
    "message": "Deployment failed due to timeout"
  },
  "custom_provider_id": "cpr_1aBcDeFgHjKlMnPq",
  "provider_id": "pro_5gHjKlMnPqRsTuVw",
  "custom_provider_deployment_id": "cpd_1aBcDeFgHjKlMnPq",
  "to_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"
  },
  "from_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"
  },
  "target_custom_provider_version": {
    "object": "custom_provider.version",
    "id": "cpv_1aBcDeFgHjKlMnPq",
    "status": "queued",
    "index": 1,
    "identifier": "v1.0.0",
    "deployment": {
      "object": "custom_provider.deployment",
      "id": "cpd_1aBcDeFgHjKlMnPq",
      "status": "queued",
      "trigger": "manual",
      "custom_provider_id": "cpr_1aBcDeFgHjKlMnPq",
      "provider_id": "pro_5gHjKlMnPqRsTuVw",
      "custom_provider_version_id": "cpv_1aBcDeFgHjKlMnPq",
      "commit": {
        "object": "custom_provider.deployment.commit",
        "type": "merge"
      },
      "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"
        }
      }
    ],
    "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"
  },
  "previous_custom_provider_version": {
    "object": "custom_provider.version",
    "id": "cpv_1aBcDeFgHjKlMnPq",
    "status": "queued",
    "index": 1,
    "identifier": "v1.0.0",
    "deployment": {
      "object": "custom_provider.deployment",
      "id": "cpd_1aBcDeFgHjKlMnPq",
      "status": "queued",
      "trigger": "manual",
      "custom_provider_id": "cpr_1aBcDeFgHjKlMnPq",
      "provider_id": "pro_5gHjKlMnPqRsTuVw",
      "custom_provider_version_id": "cpv_1aBcDeFgHjKlMnPq",
      "commit": {
        "object": "custom_provider.deployment.commit",
        "type": "merge"
      },
      "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"
        }
      }
    ],
    "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"
  },
  "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",
  "applied_at": "2025-09-15T10:35:00.000Z"
}

List custom provider commits

Returns a paginated list of commits for a custom 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

id

UnionOptional

Filter by commit IDs

custom_provider_version_id

UnionOptional

Filter by version IDs

custom_provider_environment_id

UnionOptional

Filter by environment IDs

custom_provider_id

UnionOptional

Filter by custom provider IDs

provider_id

UnionOptional

Filter by provider ID(s)

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

Get custom provider commit

Retrieves a specific commit.

URL Parameters

custom_provider_commit_id

String

The unique identifier for the custom_provider_commit

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

Create custom provider commit

Creates a new commit to promote or rollback a version in an environment.

Request Body

message

String

Commit message

action

Object

The commit action to perform

POSThttp://api.metorial.com/custom-provider-commits
curl -X POST "https://api.metorial.com/custom-provider-commits" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "message": "example_message",
  "action": {
    "type": "example_type",
    "from_environment_id": "example_from_environment_id",
    "to_environment_id": "example_to_environment_id"
  }
}'