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

items

Object
{
  "items": {
    "0": {
      "object": "callback",
      "type": "webhook_managed",
      "schedule": {
        "object": "callback.schedule"
      }
    },
    "object": "example_object",
    "id": "example_id",
    "url": "example_url",
    "name": "example_name",
    "description": "example_description",
    "type": "",
    "schedule": {
      "object": "example_object",
      "interval_seconds": 0,
      "next_run_at": "2025-10-24T15:30:32.043Z"
    },
    "created_at": "2025-10-24T15:30:32.043Z",
    "updated_at": "2025-10-24T15:30:32.043Z"
  },
  "pagination": {
    "has_more_before": false,
    "has_more_after": false
  }
}

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