Provider Templates

Provider templates are reusable, consumer-facing wrappers around provider deployments.

Provider Templates object

Attributes

object

String

id

String

status

Enum

name

String

description

StringNullable

metadata

Object

A key-value map

integration_id

StringNullable

created_at

Date

updated_at

Date
{
  "object": "provider.template",
  "status": "active",
  "metadata": {}
}

List provider templates

Returns a paginated list of provider templates.

Query Parameters

limit

NumberOptional

after

StringOptional

before

StringOptional

cursor

StringOptional

order

EnumOptional

id

UnionOptional

integration_id

UnionOptional

search

StringOptional

status

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

Get provider template

Retrieves a specific provider template.

URL Parameters

provider_template_id

String

The unique identifier for the provider_template

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

Create provider template

Creates a new provider template from an existing provider deployment or creates a minimal backing deployment first.

Request Body

name

String

description

StringOptional

metadata

ObjectOptional

A key-value map

providers

Object
POSThttp://api.metorial.com/provider-templates
curl -X POST "https://api.metorial.com/provider-templates" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "name": "example_name",
  "description": "example_description",
  "metadata": {},
  "providers": {
    "provider_id": "example_provider_id",
    "provider_deployment_id": "example_provider_deployment_id",
    "provider_auth_method_id": "example_provider_auth_method_id",
    "provider_auth_credentials_id": "example_provider_auth_credentials_id",
    "provider_config_id": "example_provider_config_id",
    "name": "example_name",
    "description": "example_description",
    "metadata": {},
    "tool_filters": "example_tool_filters"
  }
}'

Update provider template

Updates an existing provider template.

URL Parameters

provider_template_id

String

The unique identifier for the provider_template

Request Body

name

StringOptional

description

StringOptional

metadata

ObjectOptional

A key-value map

providers

ObjectOptional
PATCHhttp://api.metorial.com/provider-templates/:provider_template_id
curl -X PATCH "https://api.metorial.com/provider-templates/pro_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "name": "example_name",
  "description": "example_description",
  "metadata": {},
  "providers": {
    "provider_id": "example_provider_id",
    "provider_deployment_id": "example_provider_deployment_id",
    "provider_auth_method_id": "example_provider_auth_method_id",
    "provider_auth_credentials_id": "example_provider_auth_credentials_id",
    "provider_config_id": "example_provider_config_id",
    "name": "example_name",
    "description": "example_description",
    "metadata": {},
    "tool_filters": "example_tool_filters"
  }
}'

Archive provider template

Archives an existing provider template.

URL Parameters

provider_template_id

String

The unique identifier for the provider_template

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