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

status

Enum

Config status

is_default

Boolean

Whether this is the default config

name

StringNullable

Display name

description

StringNullable

Description

metadata

ObjectNullable

Custom key-value pairs for storing additional information

tool_filter

Object

Tool filter configuration

provider_id

String

Provider ID

specification_id

String

Specification ID

deployment

ObjectNullable

from_vault

ObjectNullable

created_at

Date

Timestamp when created

updated_at

Date

Timestamp when last updated

{
  "object": "provider.config",
  "id": "pcf_7dEfGhJkLmNpQrSt",
  "status": "active",
  "name": "Production Config",
  "description": "Configuration for production environment",
  "metadata": {},
  "tool_filter": {
    "type": "allow_all"
  },
  "provider_id": "pro_5gHjKlMnPqRsTuVw",
  "specification_id": "psp_9gHjKlMnPqRsTuVw",
  "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"
  },
  "from_vault": {
    "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"
  },
  "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.

Query Parameters

limit

NumberOptional

after

StringOptional

before

StringOptional

cursor

StringOptional

order

EnumOptional

status

UnionOptional

Filter by status (active, archived)

id

UnionOptional

Filter by config ID(s)

provider_id

UnionOptional

Filter by provider ID(s)

provider_specification_id

UnionOptional

Filter by provider specification ID(s)

provider_deployment_id

UnionOptional

Filter by provider deployment ID(s)

provider_config_vault_id

UnionOptional

Filter by config vault ID(s)

actor_id

UnionOptional

Filter by actor ID(s)

consumer_id

UnionOptional

Filter by consumer ID(s)

identity_id

UnionOptional

Filter by identity ID(s)

identity_credential_id

UnionOptional

Filter by identity credential ID(s)

search

StringOptional

Search by name or description

created_at

ObjectOptional

Filter provider config creation time by date range

updated_at

ObjectOptional

Filter provider config last update time by date range

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

Get provider config

Retrieves a specific provider config by ID.

URL Parameters

provider_config_id

String

The unique identifier for the provider_config

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

Create provider config

Creates a new provider config.

Request Body

provider_id

String

Provider ID

provider_deployment_id

StringOptional

Optional provider deployment ID

name

StringOptional

description

StringOptional

metadata

ObjectOptional

Custom key-value pairs for storing additional information

tool_filters

UnionOptionalNullable
Provide exactly one of the following:
These 2 fields are mutually exclusive - include only one in your request

value

Object

Provider-specific configuration values

provider_config_vault_id

String

Config vault ID to use as template

POSThttp://api.metorial.com/provider-configs
curl -X POST "https://api.metorial.com/provider-configs" \
  -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": {},
  "tool_filters": {
    "type": "example_type",
    "keys": [
      "example_item"
    ]
  },
  "value": {}
}'

Update provider config

Updates a specific provider config.

URL Parameters

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

tool_filters

UnionOptionalNullable
PATCHhttp://api.metorial.com/provider-configs/:provider_config_id
curl -X PATCH "https://api.metorial.com/provider-configs/pro_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "name": "example_name",
  "description": "example_description",
  "metadata": {},
  "tool_filters": {
    "type": "example_type",
    "keys": [
      "example_item"
    ]
  }
}'

Delete provider config

Permanently deletes a provider config.

URL Parameters

provider_config_id

String

The unique identifier for the provider_config

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

Get config schema

Retrieves the JSON Schema for configuration of this provider deployment.

Query Parameters

provider_id

StringOptional

provider_config_id

StringOptional

provider_version_id

StringOptional

provider_deployment_id

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