veryfront__list_project_webhookspage_info.next is the cursor of the next page.
Access
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 | Provide the runtime target kind. |
target_environment_id | string or null | No | Provide the target environment id. |
target_branch_id | string or null | No | Provide the target branch id. |
source_target_kind | string | No | Provide the source target kind. Values: "project", "main_branch", "environment", "preview_branch". |
limit | integer | No | Maximum webhooks to return. Without limit and cursor every webhook is returned; with a cursor alone, a page holds up to 100. Minimum: 1. Maximum: 100. |
cursor | string | No | page_info.next of the previous page. Keep sort_order the same across pages. Only webhooks is paged; source_webhooks is listed on the first page only. Format: uuid. |
sort_order | string | No | Creation order. Defaults to desc (newest first). Values: "asc", "desc". |
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_project_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 |
|---|---|---|---|
webhooks | object[] | Yes | List of webhooks associated with this record. |
page_info | object | Yes | Cursors of webhooks; next is null on the last page. |
source_webhooks | object[] | Yes | List of source webhooks associated with this record. |
diagnostics | object[] | Yes | List of diagnostics associated with this record. |
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": "Provide the runtime target kind."
},
{
"type": "null",
"description": "Provide the runtime target kind."
}
],
"description": "Provide the runtime target kind."
},
"target_environment_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"description": "Provide the target environment id."
},
{
"type": "null",
"description": "Provide the target environment id."
}
],
"description": "Provide the target environment id."
},
"target_branch_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"description": "Provide the target branch id."
},
{
"type": "null",
"description": "Provide the target branch id."
}
],
"description": "Provide the target branch id."
},
"source_target_kind": {
"type": "string",
"enum": [
"project",
"main_branch",
"environment",
"preview_branch"
],
"description": "Provide the source target kind."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "Maximum webhooks to return. Without limit and cursor every webhook is returned; with a cursor alone, a page holds up to 100."
},
"cursor": {
"type": "string",
"format": "uuid",
"description": "page_info.next of the previous page. Keep sort_order the same across pages. Only webhooks is paged; source_webhooks is listed on the first page only."
},
"sort_order": {
"type": "string",
"enum": [
"asc",
"desc"
],
"description": "Creation order. Defaults to desc (newest first)."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#",
"description": "Arguments for the list_project_webhooks tool."
}
{
"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": "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": "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."
},
"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": "The target associated with this record."
},
"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": "The mode associated with this record."
},
"conditions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"path": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"description": "The path associated with this record."
},
"operator": {
"type": "string",
"enum": [
"equals",
"not_equals",
"in",
"exists",
"contains"
],
"description": "The operator associated with this record."
},
"value": {
"description": "The value associated with this record."
}
},
"required": [
"path",
"operator"
],
"additionalProperties": false,
"description": "One condition item associated with this record."
},
"maxItems": 50,
"description": "List of conditions associated with this record."
}
},
"required": [
"mode",
"conditions"
],
"additionalProperties": false,
"description": "Structured event filter details associated with this record."
},
{
"type": "null",
"description": "The event filter returned by the tool."
}
],
"description": "The event filter associated with this record."
},
"status": {
"type": "string",
"enum": [
"draft",
"enabled",
"disabled"
],
"description": "Lifecycle status for the record."
},
"runtime_target_kind": {
"type": "string",
"enum": [
"main_branch",
"environment",
"preview_branch"
],
"description": "The runtime target kind associated with this record."
},
"runtime_target_environment_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"description": "The runtime target environment id associated with this record."
},
{
"type": "null",
"description": "The runtime target environment id returned by the tool."
}
],
"description": "The runtime target environment id associated with this record."
},
"runtime_target_branch_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"description": "The runtime target branch id associated with this record."
},
{
"type": "null",
"description": "The runtime target branch id returned by the tool."
}
],
"description": "The runtime target branch id associated with this record."
},
"definition_source": {
"type": "string",
"enum": [
"manual",
"source"
],
"description": "The definition source associated with this record."
},
"source_trigger_id": {
"type": [
"string",
"null"
],
"description": "The source trigger id associated with this record."
},
"source_path": {
"type": [
"string",
"null"
],
"description": "The source path associated with this record."
},
"source_hash": {
"type": [
"string",
"null"
],
"description": "The source hash associated with this 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",
"runtime_target_kind",
"runtime_target_environment_id",
"runtime_target_branch_id",
"definition_source",
"source_trigger_id",
"source_path",
"source_hash",
"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."
},
"page_info": {
"type": "object",
"properties": {
"self": {
"type": [
"string",
"null"
],
"description": "Cursor that refers to the current page."
},
"first": {
"type": "null"
},
"next": {
"type": [
"string",
"null"
],
"description": "Cursor for the next page when pagination is available."
},
"prev": {
"type": [
"string",
"null"
],
"description": "Cursor for the previous page when pagination is available."
}
},
"required": [
"self",
"first",
"next",
"prev"
],
"additionalProperties": false,
"description": "Cursors of webhooks; next is null on the last page."
},
"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": "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."
},
"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": "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",
"page_info",
"source_webhooks",
"diagnostics"
],
"additionalProperties": false,
"description": "Structured list webhooks output schema for MCP tools.",
"$schema": "http://json-schema.org/draft-07/schema#"
}