---
title: "List custom tool invocation logs"
method: GET
path: "/tools/logs"
tags: ["Custom tools"]
deprecated: true
---

# List custom tool invocation logs

`GET /tools/logs`

## Request

- Base URL: `https://platform-api.visitoai.com/m2m/v1`
- URL: `https://platform-api.visitoai.com/m2m/v1/tools/logs`
- Auth: HTTP bearer

> **Deprecated.**

Requires `tools:logs:read`. Deprecated compatibility API; unchanged behavior and legacy scope. Migrate to list_http_action_diagnostics, actions:http:diagnostics:read. Use actionId=http:<toolId>; diagnosticId=logId. New grants must be explicitly approved. No retirement date is assigned. See /api-docs/actions-api#tools-migration.

## Query parameters

- `toolId` string
- `limit` integer

## Response `200`

Invocation logs

- ToolLogsResponse
  - `logs` ToolLog[], required
    - `logId` string, required
    - `tenantId` string, required
    - `toolId` string, required
    - `toolName` string, required
    - `conversationId` string
    - `status` 'processing' | 'completed' | 'failed', required
    - `method` string, required
    - `url` string, required
    - `requestPayload` object
    - `requestHeaders` object
    - `responseStatus` integer
    - `responsePayload` unknown
    - `error` ToolInvocationError
      - `code` string, required
      - `message` string, required
      - `retryable` boolean, required
    - `durationMs` integer
    - `startedAt` string, date-time, required
    - `completedAt` string, date-time
    - `failedAt` string, date-time
  - `hasMore` boolean
  - `nextCursor` string

## Other responses

- `default`: Structured error

---

[API](https://skmtc.dev/visitoai/apis/visito-m2m-api.md) - [All operations](https://skmtc.dev/visitoai/apis/visito-m2m-api/llms.txt) - [OpenAPI document](https://skmtc.dev/visitoai/apis/visito-m2m-api/revisions/98377d35c234?raw)