Administration (opt-in)

Webhooks

List Webhooks

read-onlyidempotentopen-world

discourse_list_webhooks

List safe webhook summaries and the live authoring catalog without exposing webhook secrets or destination credentials.

List Webhooks

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_list_webhooks",
    "arguments": {
        "offset": 0,
        "limit": 1,
        "active": true,
        "delivery_status": "inactive",
        "include_catalog": true
      }
  }
}

const result = await client.callTool({
  "name": "discourse_list_webhooks",
  "arguments": {
    "offset": 0,
    "limit": 1,
    "active": true,
    "delivery_status": "inactive",
    "include_catalog": true
  }
});

result = await session.call_tool("discourse_list_webhooks", arguments={
  "offset": 0,
  "limit": 1,
  "active": true,
  "delivery_status": "inactive",
  "include_catalog": true
})

Parameters

offsetinteger>= 0

limitinteger[1, 50]

activeboolean

delivery_statusstringinactivefailedsuccessfuldisabled

include_catalogboolean

Get Webhook

read-onlyidempotentopen-world

discourse_get_webhook

Get one fresh safe webhook configuration for inspection and mutation preconditions.

Get Webhook

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_get_webhook",
    "arguments": {
        "webhook_id": 0,
        "include_catalog": true
      }
  }
}

const result = await client.callTool({
  "name": "discourse_get_webhook",
  "arguments": {
    "webhook_id": 0,
    "include_catalog": true
  }
});

result = await session.call_tool("discourse_get_webhook", arguments={
  "webhook_id": 0,
  "include_catalog": true
})

Parameters

webhook_idintegerrequired

include_catalogboolean

Create Webhook

open-world

discourse_create_webhook

Create a guarded outbound webhook using the live event and content-type catalog. External delivery and risky options require explicit confirmation.

Create Webhook

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_create_webhook",
    "arguments": {
        "payload_url": "https://example.com",
        "content_type": "application/json",
        "secret": "string",
        "active": true,
        "verify_certificate": true,
        "wildcard_web_hook": true,
        "event_type_ids": [
          0
        ],
        "category_ids": [
          0
        ],
        "tag_ids": [
          0
        ],
        "group_ids": [
          0
        ],
        "confirm_activate": true,
        "confirm_wildcard": true,
        "confirm_insecure_http": true,
        "confirm_disable_tls_verification": true,
        "confirm_external_delivery": true
      }
  }
}

const result = await client.callTool({
  "name": "discourse_create_webhook",
  "arguments": {
    "payload_url": "https://example.com",
    "content_type": "application/json",
    "secret": "string",
    "active": true,
    "verify_certificate": true,
    "wildcard_web_hook": true,
    "event_type_ids": [
      0
    ],
    "category_ids": [
      0
    ],
    "tag_ids": [
      0
    ],
    "group_ids": [
      0
    ],
    "confirm_activate": true,
    "confirm_wildcard": true,
    "confirm_insecure_http": true,
    "confirm_disable_tls_verification": true,
    "confirm_external_delivery": true
  }
});

result = await session.call_tool("discourse_create_webhook", arguments={
  "payload_url": "https://example.com",
  "content_type": "application/json",
  "secret": "string",
  "active": true,
  "verify_certificate": true,
  "wildcard_web_hook": true,
  "event_type_ids": [
    0
  ],
  "category_ids": [
    0
  ],
  "tag_ids": [
    0
  ],
  "group_ids": [
    0
  ],
  "confirm_activate": true,
  "confirm_wildcard": true,
  "confirm_insecure_http": true,
  "confirm_disable_tls_verification": true,
  "confirm_external_delivery": true
})

Parameters

payload_urlstring<uri>required

content_typestringapplication/jsonapplication/x-www-form-urlencodedrequired

secretstring

activeboolean

verify_certificateboolean

wildcard_web_hookboolean

event_type_idsArray<integer>

category_idsArray<integer>

tag_idsArray<integer>

group_idsArray<integer>

confirm_activateboolean

confirm_wildcardboolean

confirm_insecure_httpboolean

confirm_disable_tls_verificationboolean

confirm_external_deliverybooleanrequired

Update Webhook

destructiveopen-world

discourse_update_webhook

Partially update a webhook after fresh destination and active-state preconditions. Relationship arrays are complete replacements.

Update Webhook

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_update_webhook",
    "arguments": {
        "payload_url": "https://example.com",
        "content_type": "application/json",
        "secret": "string",
        "active": true,
        "verify_certificate": true,
        "wildcard_web_hook": true,
        "event_type_ids": [
          0
        ],
        "category_ids": [
          0
        ],
        "tag_ids": [
          0
        ],
        "group_ids": [
          0
        ],
        "confirm_activate": true,
        "confirm_wildcard": true,
        "confirm_insecure_http": true,
        "confirm_disable_tls_verification": true,
        "webhook_id": 0,
        "expected_destination_fingerprint": "string",
        "expected_active": true,
        "confirm_update": true,
        "confirm_scope_replacement": true,
        "confirm_clear_secret": true
      }
  }
}

const result = await client.callTool({
  "name": "discourse_update_webhook",
  "arguments": {
    "payload_url": "https://example.com",
    "content_type": "application/json",
    "secret": "string",
    "active": true,
    "verify_certificate": true,
    "wildcard_web_hook": true,
    "event_type_ids": [
      0
    ],
    "category_ids": [
      0
    ],
    "tag_ids": [
      0
    ],
    "group_ids": [
      0
    ],
    "confirm_activate": true,
    "confirm_wildcard": true,
    "confirm_insecure_http": true,
    "confirm_disable_tls_verification": true,
    "webhook_id": 0,
    "expected_destination_fingerprint": "string",
    "expected_active": true,
    "confirm_update": true,
    "confirm_scope_replacement": true,
    "confirm_clear_secret": true
  }
});

result = await session.call_tool("discourse_update_webhook", arguments={
  "payload_url": "https://example.com",
  "content_type": "application/json",
  "secret": "string",
  "active": true,
  "verify_certificate": true,
  "wildcard_web_hook": true,
  "event_type_ids": [
    0
  ],
  "category_ids": [
    0
  ],
  "tag_ids": [
    0
  ],
  "group_ids": [
    0
  ],
  "confirm_activate": true,
  "confirm_wildcard": true,
  "confirm_insecure_http": true,
  "confirm_disable_tls_verification": true,
  "webhook_id": 0,
  "expected_destination_fingerprint": "string",
  "expected_active": true,
  "confirm_update": true,
  "confirm_scope_replacement": true,
  "confirm_clear_secret": true
})

Parameters

payload_urlstring<uri>

content_typestringapplication/jsonapplication/x-www-form-urlencoded

secretstring

activeboolean

verify_certificateboolean

wildcard_web_hookboolean

event_type_idsArray<integer>

category_idsArray<integer>

tag_idsArray<integer>

group_idsArray<integer>

confirm_activateboolean

confirm_wildcardboolean

confirm_insecure_httpboolean

confirm_disable_tls_verificationboolean

webhook_idintegerrequired

expected_destination_fingerprintstringrequired

expected_activebooleanrequired

confirm_updatebooleanrequired

confirm_scope_replacementboolean

confirm_clear_secretboolean

Delete Webhook

destructiveopen-world

discourse_delete_webhook

Delete one webhook after a fresh exact destination-fingerprint precondition.

Delete Webhook

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_delete_webhook",
    "arguments": {
        "webhook_id": 0,
        "expected_destination_fingerprint": "string",
        "confirm_delete": true
      }
  }
}

const result = await client.callTool({
  "name": "discourse_delete_webhook",
  "arguments": {
    "webhook_id": 0,
    "expected_destination_fingerprint": "string",
    "confirm_delete": true
  }
});

result = await session.call_tool("discourse_delete_webhook", arguments={
  "webhook_id": 0,
  "expected_destination_fingerprint": "string",
  "confirm_delete": true
})

Parameters

webhook_idintegerrequired

expected_destination_fingerprintstringrequired

confirm_deletebooleanrequired

List Webhook Events

read-onlyidempotentopen-world

discourse_list_webhook_events

List bounded webhook delivery diagnostics. Payload and response previews are omitted unless explicitly confirmed.

List Webhook Events

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_list_webhook_events",
    "arguments": {
        "webhook_id": 0,
        "status": "all",
        "offset": 0,
        "include_content": true,
        "confirm_sensitive_content": true,
        "content_limit": 100
      }
  }
}

const result = await client.callTool({
  "name": "discourse_list_webhook_events",
  "arguments": {
    "webhook_id": 0,
    "status": "all",
    "offset": 0,
    "include_content": true,
    "confirm_sensitive_content": true,
    "content_limit": 100
  }
});

result = await session.call_tool("discourse_list_webhook_events", arguments={
  "webhook_id": 0,
  "status": "all",
  "offset": 0,
  "include_content": true,
  "confirm_sensitive_content": true,
  "content_limit": 100
})

Parameters

webhook_idintegerrequired

statusstringallsuccessfulfailed

offsetinteger>= 0

include_contentboolean

confirm_sensitive_contentboolean

content_limitinteger[100, 20000]

Ping Webhook

open-world

discourse_ping_webhook

Enqueue one explicitly confirmed external webhook ping after a fresh destination precondition.

Ping Webhook

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_ping_webhook",
    "arguments": {
        "webhook_id": 0,
        "expected_destination_fingerprint": "string",
        "confirm_external_request": true
      }
  }
}

const result = await client.callTool({
  "name": "discourse_ping_webhook",
  "arguments": {
    "webhook_id": 0,
    "expected_destination_fingerprint": "string",
    "confirm_external_request": true
  }
});

result = await session.call_tool("discourse_ping_webhook", arguments={
  "webhook_id": 0,
  "expected_destination_fingerprint": "string",
  "confirm_external_request": true
})

Parameters

webhook_idintegerrequired

expected_destination_fingerprintstringrequired

confirm_external_requestbooleanrequired

Redeliver Webhook Event

destructiveopen-world

discourse_redeliver_webhook_event

Redeliver exactly one old webhook event after destination, ownership, and status preconditions. Bulk redelivery is not exposed.

Redeliver Webhook Event

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_redeliver_webhook_event",
    "arguments": {
        "webhook_id": 0,
        "event_id": 0,
        "expected_destination_fingerprint": "string",
        "expected_event_status": -1,
        "confirm_redelivery": true
      }
  }
}

const result = await client.callTool({
  "name": "discourse_redeliver_webhook_event",
  "arguments": {
    "webhook_id": 0,
    "event_id": 0,
    "expected_destination_fingerprint": "string",
    "expected_event_status": -1,
    "confirm_redelivery": true
  }
});

result = await session.call_tool("discourse_redeliver_webhook_event", arguments={
  "webhook_id": 0,
  "event_id": 0,
  "expected_destination_fingerprint": "string",
  "expected_event_status": -1,
  "confirm_redelivery": true
})

Parameters

webhook_idintegerrequired

event_idintegerrequired

expected_destination_fingerprintstringrequired

expected_event_statusinteger[-1, 999]required

confirm_redeliverybooleanrequired

Docs by Sourcey