Sign in
integrations

Dashboard test surface: invoke a tool by slug (VENDOR_API)

Fire a real VENDOR_API invocation from the Integrations dashboard.

Verifies the parent connection is owned by the caller's org (404 otherwise), then dispatches invoke_tool_by_slug so the operator can confirm the backend action path end-to-end. Emits an integration_tool_call Tinybird row with mode=vendor_api and reason="ui_slack_test_send". An unresolved/disabled slug surfaces as ToolUnavailableError (400).

The backend result stays raw (the backend path is never narrowed). For the field-picker UI we also compute narrowed here (ENG-631) — what the agent would actually receive — using the shared :func:narrow_result. Effective field map: request.response_field_map → the saved tool's response_field_map → none (narrowed=None).

post/v1/integrations/connections/{connection_id}/test-invoke

Path parameters

connection_idstring uuid required

Request body

slugstring required
inputobject
response_field_mapobject nullable

Response

Successful Response

resultobject required
{"stackTrail":"components:schemas:ConnectionTestInvokeResponse:properties:narrowed:anyOf","oasType":"schema","type":"unknown","title":"Narrowed","nullable":true}

Changes

Changed in 1 of the 3 revisions of this API.6

  • 5a5597ebb2d66See the full diff
    • ○

      added the optional property retry_after to the response with the 400 status

      response-optional-property-added

    • ○

      added the optional property retry_after to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property retry_after to the response with the 404 status

      response-optional-property-added

    • ○

      added the optional property retryable to the response with the 400 status

      response-optional-property-added

    • ○

      added the optional property retryable to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property retryable to the response with the 404 status

      response-optional-property-added

    This revision also has 40 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog