Create a tool call log

POST

/api/tool-logs

Records a single tool/integration invocation. Primarily used by the voice runtime to log outbound webhook calls made during a conversation.

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

X-API-Key: ********************

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Tool call log created.

Bodyapplication/json

🟠401

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.snakk.ai/api/tool-logs' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "tenant_id": "11111111-2222-3333-4444-555555555555",
    "agent_id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
    "call_id": "99999999-8888-7777-6666-555555555555",
    "tool_name": "book_appointment",
    "tool_type": "webhook",
    "webhook_url": "https://example.com/hooks/booking",
    "request_method": "POST",
    "request_headers": {
        "content-type": "application/json"
    },
    "request_body": {
        "date": "2026-07-01"
    },
    "response_status": 200,
    "response_body": {
        "ok": true
    },
    "response_time_ms": 412,
    "success": true,
    "room_name": "room-abc123",
    "phone_number": "+4740000000"
}'

Response Example

201 - Example 1

{
    "log": {
        "id": "string",
        "tool_name": "string",
        "success": true,
        "response_status": 0,
        "response_time_ms": 0,
        "created_at": "2019-08-24T14:15:22.123Z"
    }
}

Modified at 2026-07-08 19:01:40

Get full agent detail

Get this month's minute balance