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

provider_deployment_id

String

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

provider_deployment_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

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

provider_deployment_id

String

provider_deployment

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": {},
  "provider_deployment_id": "example_provider_deployment_id"
}'

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

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": {}
}'

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_..."