Provider Config Vaults

A config vault is a saved, reusable set of configuration values. Use vaults to store credentials once and apply them to multiple deployments without re-entering.

Provider Config Vaults object

Attributes

object

String

String representing the object's type

id

String

Unique config vault identifier

status

Enum

Status of the config vault

name

String

Display name

description

StringNullable

Description

metadata

ObjectNullable

Custom key-value pairs for storing additional information

provider_id

String

Provider ID

deployment

ObjectNullable

created_at

Date

Timestamp when created

updated_at

Date

Timestamp when last updated

{
  "object": "provider.config_vault",
  "id": "pcvt_3bCdEfGhJkLmNpQr",
  "status": "active",
  "name": "Production Secrets",
  "description": "Secure storage for production credentials",
  "metadata": {},
  "provider_id": "pro_5gHjKlMnPqRsTuVw",
  "deployment": {
    "object": "provider.deployment#preview",
    "id": "pde_1aBcDeFgHjKlMnPq",
    "name": "Production",
    "description": "Production deployment",
    "metadata": {},
    "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"
}

List provider config vaults

Returns a paginated list of provider config vaults.

Query Parameters

limit

NumberOptional

after

StringOptional

before

StringOptional

cursor

StringOptional

order

EnumOptional

status

UnionOptional

Filter by status (active, archived)

id

UnionOptional

Filter by config vault ID(s)

provider_id

UnionOptional

Filter by provider ID(s)

provider_deployment_id

UnionOptional

Filter by provider deployment ID(s)

provider_config_id

UnionOptional

Filter by provider config ID(s)

provider_config_vault_id

UnionOptional

Filter by config vault ID(s)

search

StringOptional

Search by name or description

created_at

ObjectOptional

Filter provider config vault creation time by date range

updated_at

ObjectOptional

Filter provider config vault last update time by date range

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

Get provider config vault

Retrieves a specific provider config vault by ID.

URL Parameters

provider_config_vault_id

String

The unique identifier for the provider_config_vault

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

Create provider config vault

Creates a new provider config vault.

Request Body

provider_id

String

Provider ID

provider_deployment_id

StringOptional

Provider deployment ID

name

String

description

StringOptional

metadata

ObjectOptional

Custom key-value pairs for storing additional information

value

Object

Secure configuration values to store in the vault

POSThttp://api.metorial.com/provider-config-vaults
curl -X POST "https://api.metorial.com/provider-config-vaults" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "provider_id": "example_provider_id",
  "provider_deployment_id": "example_provider_deployment_id",
  "name": "example_name",
  "description": "example_description",
  "metadata": {},
  "value": {}
}'

Update provider config vault

Updates a specific provider config vault.

URL Parameters

provider_config_vault_id

String

The unique identifier for the provider_config_vault

Request Body

name

StringOptional

description

StringOptional

metadata

ObjectOptional

Custom key-value pairs for storing additional information

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

Delete provider config vault

Permanently deletes a provider config vault.

URL Parameters

provider_config_vault_id

String

The unique identifier for the provider_config_vault

DELETEhttp://api.metorial.com/provider-config-vaults/:provider_config_vault_id
curl -X DELETE "https://api.metorial.com/provider-config-vaults/pro_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_..."