Provider Triggers

A provider trigger describes an event source a provider can emit for callbacks. Use triggers to discover which callback subscriptions a provider version supports.

Provider Triggers object

Attributes

object

String

String representing the object's type

id

String

Unique provider trigger identifier

key

String

Trigger key used when subscribing callbacks

name

String

Display name of the trigger

description

StringNullable

Trigger description

input_schema

ObjectNullable

output_schema

ObjectNullable

invocation

Object

provider_id

String

Provider ID

provider_specification_id

String

Provider specification ID

created_at

Date

Timestamp when created

updated_at

Date

Timestamp when last updated

{
  "object": "provider.capabilities.trigger",
  "id": "ptr_4nOpQrStUvWxYzAb",
  "key": "messages.created",
  "name": "Messages Created",
  "description": "Fires whenever a new message is created in the provider",
  "input_schema": {
    "type": "json_schema",
    "schema": {}
  },
  "output_schema": {
    "type": "json_schema",
    "schema": {}
  },
  "invocation": {
    "type": "polling",
    "interval_seconds": 60
  },
  "provider_id": "pro_5gHjKlMnPqRsTuVw",
  "provider_specification_id": "psp_9gHjKlMnPqRsTuVw",
  "created_at": "2025-09-15T10:30:00.000Z",
  "updated_at": "2026-01-10T14:45:00.000Z"
}

List provider triggers

Returns a paginated list of provider triggers for a specific provider version.

Query Parameters

limit

NumberOptional

after

StringOptional

before

StringOptional

cursor

StringOptional

order

EnumOptional

provider_version_id

String

Provider version to list triggers for

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

Get provider trigger

Retrieves a specific provider trigger by ID.

URL Parameters

provider_trigger_id

String

The unique identifier for the provider_trigger

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