Sign in

v48

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-305398191.8 KB
connect

Subscribe to trigger

Subscribe to (or refresh) a trigger. Supplying the same (params, delivery.url) refreshes the TTL and may rotate the secret.

post/{namespace}/{connectionId}/.triggers/{triggerName}

Path parameters

namespacestring required
connectionIdstring required
triggerNamestring required

Request body

paramsLooseObject required

Example request

{
  "delivery": {
    "url": "https://my-app.example.com/events",
    "secret": "whsec_dGVzdF9zZWNyZXRfMjRfYnl0ZXNfbWluaW11bSE="
  }
}

Response

Subscription created or refreshed

idstring required

Stable subscription id derived from (namespace, connection, name, params, delivery.url). Used by the receiver to route via X-MCP-Subscription-Id.

refreshBeforestring required

ISO 8601 timestamp at which the subscription expires unless refreshed.

Example response

{
  "id": "trg_01HW1234567890",
  "refreshBefore": "2026-04-22T13:00:00.000Z"
}