---
title: "Read one custom tool invocation log"
method: GET
path: "/tools/logs/{logId}"
tags: ["Custom tools"]
deprecated: true
---

# Read one custom tool invocation log

`GET /tools/logs/{logId}`

## Request

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

> **Deprecated.**

Requires `tools:logs:read`. Deprecated compatibility API; unchanged behavior and legacy scope. Migrate to get_http_action_diagnostic, 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.

## Path parameters

- `logId` string, required

## Response `200`

Invocation log

- ToolLogResponse
  - `log` 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

## 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)