Custom Provider Deployments

Get custom provider deployment

Retrieves a specific deployment.

get/custom-provider-deployments/{custom_provider_deployment_id}

Request

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

Path parameters

custom_provider_deployment_idstring required

Unique identifier of the custom provider deployment.

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.deployment' required

String representing the object's type

idstring required

Unique custom provider deployment identifier

status'failed' | 'queued' | 'deploying' | 'succeeded' required

Current deployment status

trigger'manual' | 'system' | 'scm' required

What triggered this deployment

custom_provider_idstring required

ID of the parent custom provider

provider_idstring nullable required

ID of the associated provider

custom_provider_version_idstring nullable required

ID of the custom provider version being deployed

created_atstring date-time required

Timestamp when created

updated_atstring date-time required

Timestamp when last updated

Example response

{
  "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"
}

Changes

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