MEmetorial
Provider Deployments

Create provider deployment

Creates a new provider deployment.

post/provider-deployments

Request

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

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.

Request body

namestring
descriptionstring
metadataobject

Custom key-value pairs for storing additional information

provider_idstring required

The provider to deploy

locked_provider_version_idstring

Pin this deployment to a specific provider version

provider_config_idstring

Existing provider config ID

Example request

{
  "name": "Production Deployment",
  "description": "Main production environment configuration",
  "provider_id": "pro_5gHjKlMnPqRsTuVw",
  "locked_provider_version_id": "prv_4dEfGhJkLmNpQrSt",
  "provider_config_id": "pcf_7dEfGhJkLmNpQrSt",
  "provider_config": {
    "name": "Default Config"
  }
}

Response

Successful response

object'provider.deployment' required

String representing the object's type

idstring required

Unique deployment identifier

status'active' | 'archived' | 'deleted' required

Deployment status

is_defaultboolean required

Whether this is the default deployment

namestring nullable required

Display name

descriptionstring nullable required

Description

metadataobject nullable required

Custom key-value pairs for storing additional information

provider_idstring required

Provider ID

created_atstring date-time required

Timestamp when created

updated_atstring date-time required

Timestamp when last updated

Example response

{
  "id": "pde_1aBcDeFgHjKlMnPq",
  "name": "Production",
  "description": "Production deployment",
  "provider_id": "pro_5gHjKlMnPqRsTuVw",
  "locked_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"
  },
  "default_config": {
    "id": "pcf_7dEfGhJkLmNpQrSt",
    "name": "Production Config",
    "description": "Configuration for production environment",
    "provider_id": "pro_5gHjKlMnPqRsTuVw",
    "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.