Session Template Providers

Session template providers define which providers should be included when a session is created from a template.

Session Template Providers object

Attributes

object

String

String representing the object's type

id

String

Unique session template provider identifier

name

StringNullable

Display name

description

StringNullable

Description

metadata

ObjectNullable

Custom key-value pairs

session_template_id

String

Parent session template ID

provider_id

String

Provider ID

provider_deployment_id

StringNullable

Provider deployment ID

provider_deployment_name

StringNullable

Provider deployment name

provider_config_name

StringNullable

Provider config name

provider_auth_config_name

StringNullable

Provider auth config name

created_at

Date

Timestamp when created

updated_at

Date

Timestamp when last updated

{
  "object": "session.template.provider",
  "id": "stp_3cDeFgHjKlMnPqRs",
  "name": "GitHub Provider",
  "description": "GitHub integration for this template",
  "metadata": {
    "priority": 1
  },
  "session_template_id": "stm_2bCdEfGhJkLmNpQr",
  "provider_id": "pro_5gHjKlMnPqRsTuVw",
  "provider_deployment_id": "pde_1aBcDeFgHjKlMnPq",
  "provider_deployment_name": "Production",
  "provider_config_name": "Default Config",
  "provider_auth_config_name": "OAuth Config",
  "created_at": "2025-09-15T10:30:00.000Z",
  "updated_at": "2026-01-10T14:45:00.000Z"
}

List session template providers

Returns a paginated list of providers configured for a session template.

URL Parameters

session_template_id

String

The unique identifier for the session_template

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

provider_id

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

Get session template provider

Retrieves a specific provider configuration from a session template.

URL Parameters

session_template_id

String

The unique identifier for the session_template

session_template_provider_id

String

The unique identifier for the session_template_provider

GEThttp://api.metorial.com/session-templates/:session_template_id/providers/:session_template_provider_id
curl -X GET "https://api.metorial.com/session-templates/ses_Rm4Mnheq2bfEPhBhP7SY/providers/ses_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_..."

Create session template provider

Adds a new provider configuration to a session template.

URL Parameters

session_template_id

String

The unique identifier for the session_template

Request Body

name

StringOptional

description

StringOptional

metadata

ObjectOptional

A key-value map

provider_deployment

Object

provider_config

ObjectOptional

provider_auth_config

ObjectOptional

tool_filters

ObjectOptional
POSThttp://api.metorial.com/session-templates/:session_template_id/providers
curl -X POST "https://api.metorial.com/session-templates/ses_Rm4Mnheq2bfEPhBhP7SY/providers" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "name": "example_name",
  "description": "example_description",
  "metadata": {},
  "provider_deployment": {
    "type": "example_type",
    "provider_deployment_id": "example_provider_deployment_id"
  },
  "provider_config": {
    "type": "example_type",
    "provider_config_id": "example_provider_config_id"
  },
  "provider_auth_config": {
    "type": "example_type",
    "provider_auth_config_id": "example_provider_auth_config_id"
  },
  "tool_filters": {
    "tool_keys": [
      "example_item"
    ]
  }
}'

Update session template provider

Updates a provider configuration in a session template.

URL Parameters

session_template_id

String

The unique identifier for the session_template

session_template_provider_id

String

The unique identifier for the session_template_provider

Request Body

name

StringOptional

description

StringOptional

metadata

ObjectOptional

A key-value map

provider_deployment

ObjectOptional

provider_config

ObjectOptional

provider_auth_config

ObjectOptional

tool_filters

ObjectOptional
PATCHhttp://api.metorial.com/session-templates/:session_template_id/providers/:session_template_provider_id
curl -X PATCH "https://api.metorial.com/session-templates/ses_Rm4Mnheq2bfEPhBhP7SY/providers/ses_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "name": "example_name",
  "description": "example_description",
  "metadata": {},
  "provider_deployment": {
    "type": "example_type",
    "provider_deployment_id": "example_provider_deployment_id"
  },
  "provider_config": {
    "type": "example_type",
    "provider_config_id": "example_provider_config_id"
  },
  "provider_auth_config": {
    "type": "example_type",
    "provider_auth_config_id": "example_provider_auth_config_id"
  },
  "tool_filters": {
    "tool_keys": [
      "example_item"
    ]
  }
}'

Delete session template provider

Removes a provider configuration from a session template.

URL Parameters

session_template_id

String

The unique identifier for the session_template

session_template_provider_id

String

The unique identifier for the session_template_provider

DELETEhttp://api.metorial.com/session-templates/:session_template_id/providers/:session_template_provider_id
curl -X DELETE "https://api.metorial.com/session-templates/ses_Rm4Mnheq2bfEPhBhP7SY/providers/ses_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_..."