FruxonDocs
IntegrationsTools

Retrieves a specific AI Tool by ID.

Returns the tool definition (input schema, description, type) along with the pricing metadata used to estimate cost per invocation. The `(integration, tool)` pair is the composite key; the same `tool` ID under a different integration is a different resource.

GET
/v1/tenants/{tenant}/integrations/{integration}/tools/{tool}

Authorization

Bearer
AuthorizationBearer <token>

JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.

In: header

Path Parameters

integration*string

The integration identifier.

tool*string

The unique identifier of the AI Tool.

tenant*string

The tenant identifier

Response Body

curl -X GET "https://api.fruxon.com/v1/tenants/string/integrations/string/tools/string"
{
  "id": "string",
  "integrationId": "string",
  "displayName": "string",
  "description": "string",
  "toolType": "API",
  "actionType": "READ_ONLY",
  "resultType": "STRING",
  "parametersMetadata": [
    {
      "name": "string",
      "index": 0,
      "type": "String",
      "typeName": "string",
      "integerRange": {
        "min": 0,
        "max": 0
      },
      "floatRange": {
        "min": 0,
        "max": 0
      },
      "options": [],
      "asset": {
        "providers": null,
        "contentTypes": null,
        "vectorized": false
      },
      "displayName": "string",
      "description": "string",
      "required": false,
      "secret": false,
      "defaultValue": "string",
      "jsonSchema": null,
      "uiHint": "CODE",
      "rules": []
    }
  ],
  "descriptor": {
    "apiTool": {
      "headers": {},
      "httpMethod": "string",
      "url": "string",
      "queryParameters": {},
      "body": "string",
      "formParameters": {},
      "resultType": "STRING",
      "resultTransformExpression": "string"
    },
    "predefinedTool": {
      "resultType": "STRING"
    },
    "mcpTool": {
      "serverUrl": "string",
      "mcpToolName": "string",
      "resultType": "STRING"
    },
    "codeTool": {
      "code": "string",
      "timeoutSeconds": 0,
      "packages": [
        "string"
      ],
      "resultType": "STRING"
    }
  },
  "createdAt": 0,
  "modifiedAt": 0,
  "pricing": []
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}

Lists AI Tools with optional filtering, search, and pagination.

Returns a paginated list of tools registered under the integration that match the optional type and search filters, with pricing metadata attached. Use `search` for case-insensitive substring matching against tool ID, display name, and description. Use `page_size`/`page_token` to page through results.

Deletes an AI Tool.

Hard-deletes the tool definition; agents that still reference it by ID will fail to resolve the tool on their next invocation. If the tool ID appears in any integration's MCP `exposedToolIds` list it is the caller's responsibility to remove it via the MCP settings PATCH — stale entries are silently ignored by the MCP server but clutter the config.