---
title: "Dashboard test surface: invoke a tool by slug (VENDOR_API)"
method: POST
path: "/v1/integrations/connections/{connection_id}/test-invoke"
tags: ["integrations"]
---

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

`POST /v1/integrations/connections/{connection_id}/test-invoke`

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``).

## Path parameters

- `connection_id` string, uuid, required

## Request body

- ConnectionTestInvokeRequest — Body for the dashboard ``VENDOR_API`` test surface (Step 10). Lets an operator fire a real ``invoke_tool_by_slug`` from the Integrations page to confirm the backend action path end-to-end. ``input`` matches the resolved tool's ``input_schema``.
  - `slug` string, required
  - `input` object
  - `response_field_map` object, nullable

## Response `200`

Successful Response

- ConnectionTestInvokeResponse — Raw vendor result echoed back to the dashboard test surface. ``narrowed`` previews the agent-facing result after applying the effective field map (request override → saved field map); ``None`` when no field map applies (ENG-631).
  - `result` object, required
  - `narrowed` unknown

## Other responses

- `400` — Bad request
- `401` — Authentication required
- `404` — Resource not found
- `422` — Validation Error

---

[API](https://skmtc.net/oneloop-hq/apis/feather-api.md) · [All operations](https://skmtc.net/oneloop-hq/apis/feather-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oneloop-hq/feather-api/versions/888bdd5c076e/schema)