Provider Configs

A config holds settings for a deployment, like API endpoints or feature flags. Create configs with values directly, or from a saved config vault with pre-saved values.

Provider Configs object

Attributes

object

String

String representing the object's type

id

String

Unique config identifier

name

StringNullable

Display name

description

StringNullable

Description

metadata

ObjectNullable

Custom key-value pairs for storing additional information

provider_id

String

Provider ID

provider_deployment_id

StringNullable

Deployment ID

created_at

Date

Timestamp when created

updated_at

Date

Timestamp when last updated

{
  "object": "provider.config",
  "id": "pcf_7dEfGhJkLmNpQrSt",
  "name": "Production Config",
  "description": "Configuration for production environment",
  "metadata": {
    "label": "primary",
    "notes": "Default production config"
  },
  "provider_id": "pro_5gHjKlMnPqRsTuVw",
  "provider_deployment_id": "pde_1aBcDeFgHjKlMnPq",
  "created_at": "2025-09-15T10:30:00.000Z",
  "updated_at": "2026-01-10T14:45:00.000Z"
}

List provider configs

Returns a paginated list of provider configs.

URL Parameters

provider_deployment_id

String

The unique identifier for the provider_deployment

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

GEThttp://api.metorial.com/provider-deployments/:provider_deployment_id/configs
curl -X GET "https://api.metorial.com/provider-deployments/pro_Rm4Mnheq2bfEPhBhP7SY/configs" \
  -H "Authorization: Bearer metorial_sk_..."

Get provider config

Retrieves a specific provider config by ID.

URL Parameters

provider_deployment_id

String

The unique identifier for the provider_deployment

provider_config_id

String

The unique identifier for the provider_config

GEThttp://api.metorial.com/provider-deployments/:provider_deployment_id/configs/:provider_config_id
curl -X GET "https://api.metorial.com/provider-deployments/pro_Rm4Mnheq2bfEPhBhP7SY/configs/pro_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_..."

Create provider config

Creates a new provider config.

URL Parameters

provider_deployment_id

String

The unique identifier for the provider_deployment

Request Body

name

String

description

StringOptional

metadata

ObjectOptional

Custom key-value pairs for storing additional information

config

Object

Configuration data source

POSThttp://api.metorial.com/provider-deployments/:provider_deployment_id/configs
curl -X POST "https://api.metorial.com/provider-deployments/pro_Rm4Mnheq2bfEPhBhP7SY/configs" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "name": "example_name",
  "description": "example_description",
  "metadata": {},
  "config": {
    "type": "example_type",
    "data": {}
  }
}'

Update provider config

Updates a specific provider config.

URL Parameters

provider_deployment_id

String

The unique identifier for the provider_deployment

provider_config_id

String

The unique identifier for the provider_config

Request Body

name

StringOptional

description

StringOptional

metadata

ObjectOptional

Custom key-value pairs for storing additional information

PATCHhttp://api.metorial.com/provider-deployments/:provider_deployment_id/configs/:provider_config_id
curl -X PATCH "https://api.metorial.com/provider-deployments/pro_Rm4Mnheq2bfEPhBhP7SY/configs/pro_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "name": "example_name",
  "description": "example_description",
  "metadata": {}
}'

Delete provider config

Permanently deletes a provider config.

URL Parameters

provider_deployment_id

String

The unique identifier for the provider_deployment

provider_config_id

String

The unique identifier for the provider_config

DELETEhttp://api.metorial.com/provider-deployments/:provider_deployment_id/configs/:provider_config_id
curl -X DELETE "https://api.metorial.com/provider-deployments/pro_Rm4Mnheq2bfEPhBhP7SY/configs/pro_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_..."

Get config schema

Retrieves the JSON Schema for configuration of this provider deployment.

URL Parameters

provider_deployment_id

String

The unique identifier for the provider_deployment

GEThttp://api.metorial.com/provider-deployments/:provider_deployment_id/config-schema
curl -X GET "https://api.metorial.com/provider-deployments/pro_Rm4Mnheq2bfEPhBhP7SY/config-schema" \
  -H "Authorization: Bearer metorial_sk_..."