Tool details
| Field | Value |
|---|---|
| Name | list_project_webhooks |
| Group | Webhooks |
Playground
Input schema
input-schema.json
{
"type": "object",
"properties": {
"project_reference": {
"type": "string",
"description": "Project ID or slug."
}
},
"additionalProperties": false,
"description": "Structured list webhooks input schema for MCP tools.",
"$schema": "http://json-schema.org/draft-07/schema#"
}
Output schema
output-schema.json
{
"type": "object",
"properties": {
"webhooks": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "Unique identifier for the record."
},
"project_id": {
"type": "string",
"format": "uuid",
"description": "Project identifier associated with the record."
},
"name": {
"type": "string",
"description": "Human-readable name for the record."
},
"source": {
"type": "string",
"const": "webhook",
"description": "The source associated with this record."
},
"target": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"agent",
"task",
"workflow",
"event"
],
"description": "Target kind invoked or stored by the webhook."
},
"id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"description": "Target identifier: agent id, task target, workflow id, or event for store-only webhooks."
},
"conversation_mode": {
"type": "string",
"enum": [
"create_new",
"existing",
"none"
],
"description": "Agent-only conversation mode. Defaults to none."
},
"conversation_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"description": "Conversation identifier associated with the record."
},
{
"type": "null",
"description": "Conversation identifier associated with this result."
}
],
"description": "Agent-only existing conversation id. Required when conversation_mode is existing."
}
},
"required": [
"kind",
"id"
],
"additionalProperties": false,
"description": "Target invoked by a webhook definition."
},
"prompt_template": {
"type": [
"string",
"null"
],
"description": "The prompt template associated with this record."
},
"event_filter": {
"anyOf": [
{
"type": "object",
"properties": {
"mode": {
"type": "string",
"enum": [
"all",
"any"
],
"description": "Whether all or any filter conditions must match."
},
"conditions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"path": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"description": "Dot path in the incoming payload, for example action or pull_request.state."
},
"operator": {
"type": "string",
"enum": [
"equals",
"not_equals",
"in",
"exists",
"contains"
],
"description": "Comparison operator."
},
"value": {
"description": "Comparison value for operators that require one."
}
},
"required": [
"path",
"operator"
],
"additionalProperties": false,
"description": "One condition item associated with this record."
},
"maxItems": 50,
"description": "Filter conditions applied before webhook work is created."
}
},
"required": [
"mode",
"conditions"
],
"additionalProperties": false,
"description": "Optional incoming event filter. Missing, null, or empty conditions accept every event."
},
{
"type": "null",
"description": "The event filter returned by the tool."
}
],
"description": "Optional incoming event filter. Missing, null, or empty conditions accept every event."
},
"status": {
"type": "string",
"enum": [
"draft",
"enabled",
"disabled"
],
"description": "Lifecycle status for the record."
},
"webhook_id": {
"type": "string",
"description": "The webhook id associated with this record."
},
"webhook_url": {
"type": "string",
"description": "The webhook url associated with this record."
},
"created_by_user_id": {
"type": "string",
"format": "uuid",
"description": "The created by user id associated with this record."
},
"enabled_at": {
"type": [
"string",
"null"
],
"description": "The enabled at associated with this record."
},
"disabled_at": {
"type": [
"string",
"null"
],
"description": "The disabled at associated with this record."
},
"disabled_reason": {
"type": [
"string",
"null"
],
"description": "The disabled reason associated with this record."
},
"created_at": {
"type": "string",
"description": "Creation timestamp in ISO 8601 format."
},
"updated_at": {
"type": "string",
"description": "Last update timestamp in ISO 8601 format."
}
},
"required": [
"id",
"project_id",
"name",
"source",
"target",
"prompt_template",
"event_filter",
"status",
"webhook_id",
"webhook_url",
"created_by_user_id",
"enabled_at",
"disabled_at",
"disabled_reason",
"created_at",
"updated_at"
],
"additionalProperties": false,
"description": "Project webhook definition using the same public shape as REST."
},
"description": "List of webhooks associated with this record."
},
"source_webhooks": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Unique identifier for the record."
},
"name": {
"type": "string",
"description": "Human-readable name for the record."
},
"description": {
"type": [
"string",
"null"
],
"description": "Human-readable description for the record."
},
"target": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"agent",
"task",
"workflow",
"event"
],
"description": "The kind associated with this record."
},
"id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"description": "Unique identifier for the record."
},
"conversation_mode": {
"type": "string",
"enum": [
"create_new",
"existing",
"none"
],
"description": "The conversation mode associated with this record."
},
"conversation_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"description": "Conversation identifier associated with the record."
},
{
"type": "null",
"description": "Conversation identifier associated with this result."
}
],
"description": "Conversation identifier associated with the record."
}
},
"required": [
"kind",
"id"
],
"additionalProperties": false,
"description": "The target associated with this record."
},
"prompt_template": {
"type": [
"string",
"null"
],
"description": "The prompt template associated with this record."
},
"event_filter": {
"anyOf": [
{
"description": "The event filter associated with this record."
},
{
"type": "null",
"description": "The event filter returned by the tool."
}
],
"description": "The event filter associated with this record."
},
"definition_source": {
"type": "string",
"const": "source",
"description": "The definition source associated with this record."
},
"source_trigger_id": {
"type": "string",
"description": "The source trigger id associated with this record."
},
"source_path": {
"type": "string",
"description": "The source path associated with this record."
},
"source_hash": {
"type": "string",
"description": "The source hash associated with this record."
},
"edit_mode": {
"type": "string",
"enum": [
"structured",
"source_only"
],
"description": "The edit mode associated with this record."
}
},
"required": [
"id",
"name",
"description",
"target",
"prompt_template",
"definition_source",
"source_trigger_id",
"source_path",
"source_hash",
"edit_mode"
],
"additionalProperties": false,
"description": "One source webhook item associated with this record."
},
"description": "List of source webhooks associated with this record."
},
"diagnostics": {
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "source_file_diagnostic",
"description": "The kind associated with this record."
},
"source_kind": {
"type": "string",
"enum": [
"agent",
"prompt",
"tool",
"task",
"workflow",
"resource",
"skill",
"eval",
"schedule",
"webhook"
],
"description": "The source kind associated with this record."
},
"source_path": {
"type": "string",
"minLength": 1,
"description": "The source path associated with this record."
},
"source_id": {
"type": "string",
"minLength": 1,
"description": "The source id associated with this record."
},
"code": {
"type": "string",
"enum": [
"parse_error",
"invalid_definition",
"dynamic_definition",
"duplicate_source_id",
"unsupported_target",
"manual_conflict"
],
"description": "The code associated with this record."
},
"message": {
"type": "string",
"minLength": 1,
"description": "The message associated with this record."
}
},
"required": [
"kind",
"source_kind",
"source_path",
"code",
"message"
],
"additionalProperties": false,
"description": "One diagnostic item associated with this record."
},
"description": "List of diagnostics associated with this record."
}
},
"required": [
"webhooks",
"source_webhooks",
"diagnostics"
],
"additionalProperties": false,
"description": "Structured list webhooks output schema for MCP tools.",
"$schema": "http://json-schema.org/draft-07/schema#"
}