probe_endpoint
Probe a target endpoint — Make a guarded test HTTP call to validate an endpoint before going live.
Make a guarded test HTTP call to validate an endpoint before going live. To probe a webhook you created, pass webhook_id (e.g. {{step_2.id}}) — its URL, credential and method are reused automatically, so never ask the user for the endpoint URL again. Only pass url for an endpoint not tied to a webhook. Defaults to GET/HEAD; other methods require confirmation. Returns status, redacted headers and a truncated, redacted body. The raw secret is never exposed. Registered as the WordPress Ability flowsystems-webhook-actions/probe_endpoint, so external AI tools (Claude Code, Cursor) can call it over MCP or REST with a scoped API token.
/ Plan step shape
{ "ability": "probe_endpoint", "input": { "webhook_id": …, "url": …, "method": …, "auth_credential_id": …, "headers": …, "body": …, "confirmed": … } }
/ Scope & confirmation
Minimum API-token scope for external (MCP/REST) callers: full. GET/HEAD probes run without confirmation; other HTTP methods pause for explicit user confirmation.
/ Input fields
| Name | In | Type | Req | Description |
|---|---|---|---|---|
| webhook_id | param | integer | — | Probe an existing webhook by id; reuses its endpoint URL, credential and method. Prefer this over url when probing a webhook you just created. |
| url | param | string | — | |
| method | param | string | — | GET | HEAD | POST | PUT | PATCH | DELETE |
| auth_credential_id | param | integer | — | |
| headers | param | object | — | |
| body | param | object | — | |
| confirmed | param | boolean | — |
/ Examples
Plan step as the AI Builder proposes it
{ "id": "step_1", "ability": "probe_endpoint", "summary": "…", "input": { "webhook_id": "{{step_2.id}}" } }
/ Related