---
title: "Get live tools of a dynamic action"
method: POST
path: "/orgs/connections/actions/tools"
tags: ["Connections"]
---

# Get live tools of a dynamic action

`POST /orgs/connections/actions/tools`

## Request

- Base URL: `https://api.useinvent.com`
- URL: `https://api.useinvent.com/orgs/connections/actions/tools`
- Auth: HTTP bearer

Returns the tool catalog a dynamic action (an MCP server, an OpenAPI spec) exposes for the given input, minus the excluded tools, with the time it was last loaded.

## Request body

- ConnectionActionInterfaceSchema: The interface of a connection action
  - `action_id` string, required
  - `connection_id` string
  - `input` object: Values of the fields
  - `resource_id` string
  - `definitions` DynamicFieldsSchema[]
    - `path` string, required
    - `definition` FieldsSchema, required: The definition of the field schemas

## Response `200`

- ConnectionActionDynamicToolsSchema: The live tool catalog of a dynamic action
  - `tools` ConnectionActionDynamicToolSchema[], required
    - `name` string, required
    - `description` string
    - `parameters` FieldsSchema, required: The definition of the field schemas
    - `input` object, required: Merged into the row input when the tool runs, beside the arguments
    - `write` boolean, required: Whether the tool changes data on the other side
    - `method` string: HTTP method, for tools that are API endpoints
    - `path` string: Endpoint path, for tools that are API endpoints
  - `fetched_at` string, date-time, required
  - `stale` boolean, required: The catalog could not be refreshed, this is the last one that loaded

---

[API](https://skmtc.dev/useinvent/apis/invent-api.md) · [All operations](https://skmtc.dev/useinvent/apis/invent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/useinvent/apis/invent-api/revisions/98824f3fde82?raw)