veryfront__list_source_webhooksAccess
No external-service connection is required. Use a Veryfront credential with access to the requested resources. Call type: Read-only.Arguments
| Field | Type | Required | Description and constraints |
|---|---|---|---|
project_reference | string | No | Project ID or slug. |
runtime_target_kind | string or null | No | Runtime target: main_branch, environment or preview_branch. Must match source_target_kind when both are sent. |
target_environment_id | string or null | No | Environment id, for the environment source target. |
target_branch_id | string or null | No | Branch id, for the preview_branch source target. |
source_target_kind | string | No | Source to read: project, main_branch, environment or preview_branch. Defaults to runtime_target_kind, then main_branch. Values: "project", "main_branch", "environment", "preview_branch". |
Example request
Send this JSON-RPC request through an initialized MCP client. Replace sample identifiers and values before calling the tool. See MCP client setup.request.json
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "veryfront__list_source_webhooks",
"arguments": {}
}
}
Result
The published output shape is summarized below. Inspect both the MCP response content andisError when handling a call.
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data | object[] | Yes | Webhooks declared in project source files. |
diagnostics | object[] | Yes | Source discovery diagnostics. |
errors | object[] | Yes | Source files that could not be read or parsed. |
Full schemas
{
"type": "object",
"properties": {
"project_reference": {
"type": "string",
"description": "Project ID or slug."
},
"runtime_target_kind": {
"anyOf": [
{
"type": "string",
"enum": [
"main_branch",
"environment",
"preview_branch"
],
"description": "The runtime target kind associated with this record."
},
{
"type": "null",
"description": "Provide the runtime target kind."
}
],
"description": "Runtime target: main_branch, environment or preview_branch. Must match source_target_kind when both are sent."
},
"target_environment_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"description": "The target environment id associated with this record."
},
{
"type": "null",
"description": "Provide the target environment id."
}
],
"description": "Environment id, for the environment source target."
},
"target_branch_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"description": "The target branch id associated with this record."
},
{
"type": "null",
"description": "Provide the target branch id."
}
],
"description": "Branch id, for the preview_branch source target."
},
"source_target_kind": {
"type": "string",
"enum": [
"project",
"main_branch",
"environment",
"preview_branch"
],
"description": "Source to read: project, main_branch, environment or preview_branch. Defaults to runtime_target_kind, then main_branch."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#",
"description": "Arguments for the list_source_webhooks tool."
}
{
"type": "object",
"properties": {
"data": {
"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": "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": "Conversation behaviour for an agent target. Defaults to none. Use create_new for an agent that delegates with invoke_agent - a run with no conversation cannot be paused for delegation. Agent targets run headlessly by default; create_new or existing creates or appends a conversation message. Agent targets with conversation mode create_new or existing also require project.conversations.write."
},
"conversation_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"description": "Conversation identifier associated with the record."
},
{
"type": "null",
"description": "Conversation identifier associated with this result."
}
],
"description": "Existing conversation to continue. Only allowed when conversation_mode is existing, and required in that case."
}
},
"required": [
"kind",
"id"
],
"additionalProperties": false,
"description": "Structured target details 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 data item associated with this record."
},
"description": "Webhooks declared in project source files."
},
"diagnostics": {
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"source_file_diagnostic",
"source_agent_discovery_error",
"source_trigger_discovery_error"
],
"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."
},
"details": {
"type": "object",
"additionalProperties": {
"description": "Additional structured values associated with this result."
},
"description": "The details associated with this record."
}
},
"required": [
"kind",
"source_kind",
"source_path",
"code",
"message"
],
"additionalProperties": false,
"description": "One diagnostic item associated with this record."
},
"description": "Source discovery diagnostics."
},
"errors": {
"type": "array",
"items": {
"$ref": "#/properties/diagnostics/items",
"description": "One error item returned by the tool."
},
"description": "Source files that could not be read or parsed."
}
},
"required": [
"data",
"diagnostics",
"errors"
],
"additionalProperties": false,
"description": "Webhooks declared in project source files, with discovery diagnostics and errors.",
"$schema": "http://json-schema.org/draft-07/schema#"
}