Snakk AI - Voice Agent Platform API
  1. Tool Logs
Snakk AI - Voice Agent Platform API
  • System
    • Simple health check
      GET
    • Detailed health check with dependency status
      GET
  • Tenants
    • Create new tenant (signup)
      POST
  • Agents
    • List all agents for tenant
      GET
    • Create new agent
      POST
    • Get agent details
      GET
    • Delete agent
      DELETE
    • Duplicate an agent
      POST
  • Tools
    • List tools/webhooks for agent
      GET
    • Add tool/webhook to agent
      POST
  • Calls
    • Start outbound call from database agent
      POST
    • Start outbound call with ad-hoc agent config (JSON)
      POST
    • List call history
      GET
    • Get call details
      GET
    • Diagnose recording issues
      GET
    • Call statistics
      GET
    • Fix recording data
      POST
  • Phone Numbers
    • List your phone numbers
      GET
    • Available numbers to claim
      GET
    • Claim a number from pool
      POST
    • Assign number to agent
      POST
    • Unassign number from agent
      POST
    • Release number (return to pool)
      POST
  • Statistics
    • Dashboard overview
    • Daily usage statistics
    • Monthly usage statistics
  • Subscription
    • Current subscription
    • Available plans
    • Request plan upgrade
  • Web Access
    • Generate web widget token
  • AI Tools
    • AI Prompt Generator
  • Account
    • Your account info
    • Regenerate API key
  • Platform Admin
    • Platform-wide overview (admin only)
  • Knowledge Base
    • List knowledge base files
    • Upload document to knowledge base
    • Delete knowledge base file
  • Chat Widget
    • Get chat widget config
    • Start chat session
    • Send chat message
    • Close chat session
    • List chat sessions
    • Get chat session details
    • Chat statistics
    • Get chat widget configuration
    • Update chat widget configuration
    • Close inactive sessions
    • Upload chat avatar/logo
    • Delete chat avatar/logo
    • Poll session status for human handoff
    • Poll session status (POST to avoid caching)
    • Get chat history
  • Version History
    • List agent version history
    • Get specific version details
    • Compare two versions
    • Restore agent to version
  • Workflows
    • List all workflows
    • Create workflow
    • Get workflow
    • Update workflow
    • Delete workflow
    • Publish workflow
    • Get version history
    • Rollback to version
    • Assign workflow to agent
    • Remove workflow from agent
  • Chat Operator
    • Get operator statistics
    • Get escalated chat queue
    • Get operator's active chats
    • Claim a chat from queue
    • Release a chat
    • Send message as operator
    • Update operator online status
    • Get contact requests
    • Update contact request
    • Create contact request
    • Subscribe to operator events (SSE)
    • Get all messages for a session
    • Update customer info for session
  • Chat Verification
    • Check if agent has protected tools
    • Initiate identity verification
    • Check verification status
  • Tool Logs
    • List tool call logs
      GET
    • Get single tool log
      GET
    • Get tool usage statistics
      GET
  • Schemas
    • Tenant
    • Agent
    • Call
    • ToolLog
    • AgentTool
  1. Tool Logs

List tool call logs

GET
/api/tool-logs
Get a list of tool/webhook call logs for debugging. Filter by agent, status, time range, or tool name.

Request

Authorization
API Key
Add parameter in header
X-API-Key
Example:
X-API-Key: ********************
or
Query Params

Responses

🟢200
application/json
List of tool call logs
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://snakk-backend-production.up.railway.app/api/tool-logs?agent_id&call_id&tool_name&success&since&limit&offset' \
--header 'X-API-Key: <api-key>'
Response Response Example
{
    "logs": [
        {
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "tenant_id": "34f5c98e-f430-457b-a812-92637d0c6fd0",
            "agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978",
            "call_id": "0d0a16ab-a508-4d58-bf24-5dc3cb248f3e",
            "tool_name": "string",
            "tool_type": "webhook",
            "webhook_url": "string",
            "request_method": "POST",
            "request_headers": {},
            "request_body": {},
            "response_status": 0,
            "response_body": {},
            "response_time_ms": 0,
            "success": true,
            "error_message": "string",
            "room_name": "string",
            "phone_number": "string",
            "created_at": "2019-08-24T14:15:22.123Z"
        }
    ],
    "count": 0
}
Modified at 2025-12-17 20:24:15
Previous
Check verification status
Next
Get single tool log
Built with