Callbacks

Callbacks allow you to receive webhooks from MCP servers on Metorial. Callbacks are automatically created when you create a callback-enabled server deployment.

Callbacks object

Attributes

object

String

Type of the object, fixed as callback

id

String

The unique identifier of the callback

url

StringNullable

The URL to which the callback will send data (only for manual webhook type)

name

StringNullable

The name of the callback

description

StringNullable

The description of the callback

type

Enum

The type of the callback

schedule

Object

created_at

Date

Timestamp when the callback was created

updated_at

Date

Timestamp when the callback was last updated

{
  "object": "callback",
  "type": "webhook_managed",
  "schedule": {
    "object": "callback.schedule"
  }
}

List callbacks

Returns a paginated list of callbacks.

Query Parameters

limit

NumberOptional

after

StringOptional

before

StringOptional

cursor

StringOptional

order

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

Get callback by ID

Retrieves details for a specific callback by its ID.

URL Parameters

callback_id

String

The unique identifier for the callback

GEThttp://api.metorial.com/callbacks/:callback_id
curl -X GET "https://api.metorial.com/callbacks/cal_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_..."