custom_tools

Test custom tool

Execute the tool FOR REAL with the given params, through the same executor a production call takes: one HTTP call to the target, logged as a provider_calls row (source_service api, tool_type custom_tool), 0 credits, a fresh idempotency key per press. result carries the outcome verbatim: status, output {status, body, extracted}, the classified error_code and a message that opens with the token of a tool-level failure (custom_tool_disabled, input_binding...), and provider_call_sid for the snapshots. Use it to see what a column would get, or why a tool returns nothing (compare output.body with output_mapping). A dry-run that does not hit the target would validate nothing. Throttled 10 a minute.

Contract:

  • MCP tool test_custom_tool, registry package mcp.integrations/custom_tools, mount integrations.providers.
  • Operation action, response envelope action.
  • Flags: none.
post/api/custom-tools/{sid}/test

Request

  • Base URL
    https://beta.getsales.io/integrations/v1
  • Auth
    HTTP bearer and API key in header Team-SID

Path parameters

sidstring required

Custom tool sid (in_tl_...).

Request body

paramsobject

The inputs by key, bound against input_schema (a missing required one fails the row).

Response

action success envelope.

successtrue required
operation'action' required
actionstring required

kebab-case verb; matches the route segment.

Changes

No recorded changes to this operation across all 1 revision of this API.