Skip to content

List logs

GET /log

Query Parameters

log_typestring
required·

The type of logs you want to filter by. The same value is echoed on every row in the response (log_type field) so each row is self-describing.

Possible values:
unified_proxy_apirapid_bridgewebhookmcpsync_job_cron_trigger
created_atobject

The date-time range to filter the logs by.

gtstring · date-time

The logs created after this date-time. Should be in ISO 8601 format. If specified, lt must also be provided and should NOT be greater than 1 month apart from gt.

Example: 2021-10-01T00:00:00Z
ltstring · date-time

The logs created before this date-time. Should be in ISO 8601 format.

Example: 2021-10-01T00:00:00Z
limitnumber

The number of logs to return. Default is 100.

next_cursorstring

The cursor to get the next set of logs.

log_type_filterobject

The filters to apply to fetch only specific logs.

client_namestring

Filter logs by client name. Can be used when log_type is mcp.

client_versionstring

Filter logs by client version. Can be used when log_type is mcp.

environment_idstring

Filter logs by environment ID. Can be used when log_type is mcp.

integrated_account_idstring

Filter logs by integrated account ID. Can be used when log_type is mcp.

mcp_methodstring

Filter logs by MCP method. Can be used when log_type is mcp.

Possible values:
initializenotifications/initializedtools/listtools/callprompts/listresources/listping
mcp_server_idstring

Filter logs by MCP server ID. Can be used when log_type is mcp.

methodstring

Filter logs by method. Can be used when log_type is mcp.

request_idstring

Filter logs by request ID. Can be used when log_type is mcp.

request_typestring

The type of request for which the logs are generated. Can be used when log_type is unified_proxy_api.

Possible values:
proxyunified
resourcestring

Filter logs by resource. Can be used when log_type is mcp.

tool_namestring

Filter logs by tool name. Can be used when log_type is mcp.

Response Body

next_cursorstring

The cursor to get the next set of logs. Null when there are no more results.

resultarray

The list of logs.

One of
unified_proxy_api · 33 properties
app_envstring

The deployment environment that wrote the log.

Example: production
Possible values:
productionstaging
authentication_typestring

How the request was authenticated.

Example: api_token
Possible values:
sessionapi_tokenintegrated_account
durationnumber

Total time in milliseconds between Truto receiving the request and sending the response.

Example: 150
environment_idstring · uuid

The Truto environment in which the log was generated.

Example: 1ba1f401-7183-47c5-9e39-e8e257e3c795
fetch_durationnumber

Time in milliseconds spent fetching data from the upstream API.

Example: 50
hoststring

The hostname that served the request.

Example: api.truto.one
http_countrystring

The country code of the client (from Cloudflare).

Example: US
http_ipstring

The IP address of the client.

Example: 86.48.10.39
http_methodstring

The HTTP method of the request.

Example: GET
http_request_idstring

The Cloudflare Ray ID for the request.

Example: 9fc8527ebf27a066
http_status_codeinteger

The HTTP status code of the response.

Example: 200
http_urlstring

The full URL of the request (with sensitive paths masked).

Example: https://api.truto.one/unified/crm/contacts?integrated_account_id=...
http_url_details_hoststring

The hostname portion of the request URL.

Example: api.truto.one
http_url_details_pathstring

The path portion of the request URL.

Example: /unified/crm/contacts
http_url_details_query_stringRecord<string, any>

The parsed query string parameters of the request URL.

http_url_details_schemestring

The URL scheme.

Example: https:
http_useragentstring

The User-Agent header of the request.

http_versionstring

The HTTP protocol version.

Example: HTTP/2
integrated_account_idstring · uuid

The integrated account that the request was made against.

Example: 1ba1f401-7183-47c5-9e39-e8e257e3c795
integrated_account_needs_reauthboolean

Whether the integrated account's credentials need to be refreshed.

integrationstring

The integration name that handled the request.

Example: hubspot
log_typestring
Example: unified_proxy_api
Possible values:
unified_proxy_api
logsstring[]

Internal log messages captured during request/job processing.

Example: ["Token still valid — no refresh needed"]
messagestring

Human-readable summary of the log event.

Example: 2026-05-16T06:28:27.040Z INFO 86.48.10.39 (9fc8527ebf27a066) GET https://api.truto.one/unified/crm/contacts 200
methodstring

The Truto method that was called (list, get, create, update, delete, or a custom method name).

Example: list
remote_requestsobject[]

Upstream HTTP requests made to third-party APIs during processing.

2 properties
methodstring
urlstring
request_typestring

Whether the request was served by a Unified API mapping or a raw Proxy API passthrough.

Example: unified
Possible values:
unifiedproxy
resourcestring

The Truto resource that was called.

Example: contacts
response_headersRecord<string, any>

The response headers returned to the client.

result_countinteger

The number of results returned by a list operation.

servicestring

The service that generated the log.

Example: truto-api
timestampstring · date-time

The time at which the log entry was recorded.

Example: 2026-05-16T06:28:27.040Z
user_idstring · uuid

The ID of the authenticated user, if applicable.

rapid_bridge · 15 properties
app_envstring

The deployment environment that wrote the log.

Example: production
Possible values:
productionstaging
durable_objectstring

The Durable Object class that emitted the log.

Example: sync_job_run
Possible values:
sync_job_run
environment_idstring · uuid

The Truto environment in which the log was generated.

Example: 1ba1f401-7183-47c5-9e39-e8e257e3c795
integrated_account_idstring · uuid

The integrated account the sync job is running against.

Example: 1ba1f401-7183-47c5-9e39-e8e257e3c795
integrationstring

The integration the sync job is running against.

Example: hubspot
log_typestring
Example: rapid_bridge
Possible values:
rapid_bridge
logsstring[]

Internal log messages captured during request/job processing.

Example: ["Token still valid — no refresh needed"]
messagestring

Human-readable summary of the log event.

Example: 2026-05-16T06:28:27.040Z INFO 86.48.10.39 (9fc8527ebf27a066) GET https://api.truto.one/unified/crm/contacts 200
methodstring

The Truto method being executed by this sync step.

Example: list
servicestring

The service that generated the log.

Example: truto-api
sync_job_idstring · uuid

The sync job that was triggered.

sync_job_run_eventstring

The lifecycle event being logged for the sync job run.

Example: completed
sync_job_run_idstring · uuid

The specific sync job run.

timestampstring · date-time

The time at which the log entry was recorded.

Example: 2026-05-16T06:28:27.040Z
webhook_idstring · uuid

When the sync job was triggered by a webhook, the originating webhook ID.

webhook · 11 properties
app_envstring

The deployment environment that wrote the log.

Example: production
Possible values:
productionstaging
environment_idstring · uuid

The Truto environment in which the log was generated.

Example: 1ba1f401-7183-47c5-9e39-e8e257e3c795
eventstring

The event that triggered the webhook delivery.

Example: sync_job_run:created
log_typestring
Example: webhook
Possible values:
webhook
logsstring[]

Internal log messages captured during request/job processing.

Example: ["Token still valid — no refresh needed"]
messagestring

Human-readable summary of the log event.

Example: 2026-05-16T06:28:27.040Z INFO 86.48.10.39 (9fc8527ebf27a066) GET https://api.truto.one/unified/crm/contacts 200
queuestring

The Cloudflare Queue that handled the delivery.

Example: webhooks
Possible values:
webhooks
servicestring

The service that generated the log.

Example: truto-api
timestampstring · date-time

The time at which the log entry was recorded.

Example: 2026-05-16T06:28:27.040Z
webhook_endpoint_statusinteger

The HTTP status code returned by the customer's webhook endpoint.

Example: 200
webhook_idstring · uuid

The webhook configuration that fired.

mcp · 36 properties
app_envstring

The deployment environment that wrote the log.

Example: production
Possible values:
productionstaging
authentication_typestring

How the request was authenticated.

Example: api_token
Possible values:
sessionapi_tokenintegrated_account
client_namestring

The name of the MCP client.

Example: Claude-User
client_versionstring

The version of the MCP client.

durationnumber

Total time in milliseconds between Truto receiving the MCP request and sending the response.

Example: 120
environment_idstring · uuid

The Truto environment in which the log was generated.

Example: 1ba1f401-7183-47c5-9e39-e8e257e3c795
fetch_durationnumber

Time in milliseconds spent fetching data from the upstream API while servicing the MCP request.

Example: 40
hoststring

The hostname that served the request.

Example: api.truto.one
http_countrystring

The country code of the client (from Cloudflare).

Example: US
http_ipstring

The IP address of the client.

Example: 86.48.10.39
http_methodstring

The HTTP method of the request.

Example: GET
http_request_idstring

The Cloudflare Ray ID for the request.

Example: 9fc8527ebf27a066
http_status_codeinteger

The HTTP status code of the response.

Example: 200
http_urlstring

The full URL of the request (with sensitive paths masked).

Example: https://api.truto.one/unified/crm/contacts?integrated_account_id=...
http_url_details_hoststring

The hostname portion of the request URL.

Example: api.truto.one
http_url_details_pathstring

The path portion of the request URL.

Example: /unified/crm/contacts
http_url_details_query_stringRecord<string, any>

The parsed query string parameters of the request URL.

http_url_details_schemestring

The URL scheme.

Example: https:
http_useragentstring

The User-Agent header of the request.

http_versionstring

The HTTP protocol version.

Example: HTTP/2
integrated_account_idstring · uuid

The integrated account this MCP server is bound to.

Example: 1ba1f401-7183-47c5-9e39-e8e257e3c795
integrationstring

The integration name that handled the MCP request.

Example: hubspot
log_typestring
Example: mcp
Possible values:
mcp
logsstring[]

Internal log messages captured during request/job processing.

Example: ["Token still valid — no refresh needed"]
mcp_methodstring

The MCP protocol method.

Example: tools/list
Possible values:
initializenotifications/initializedtools/listtools/callprompts/listresources/listping
mcp_server_idstring · uuid

The MCP server ID.

mcp_server_namestring

The MCP server name.

messagestring

Human-readable summary of the log event.

Example: 2026-05-16T06:28:27.040Z INFO 86.48.10.39 (9fc8527ebf27a066) GET https://api.truto.one/unified/crm/contacts 200
methodstring

The Truto method backing the called tool.

request_typestring
Example: mcp
Possible values:
mcp
resourcestring

The Truto resource backing the called tool.

response_headersRecord<string, any>

The response headers returned to the client.

servicestring

The service that generated the log.

Example: truto-api
timestampstring · date-time

The time at which the log entry was recorded.

Example: 2026-05-16T06:28:27.040Z
tool_namestring

The MCP tool that was called (only set for tools/call).

user_idstring · uuid

The ID of the authenticated user, if applicable.

sync_job_cron_trigger · 8 properties
alarm_typestring

The alarm classifier emitted by the underlying Durable Object.

Example: sync_job_cron_trigger
Possible values:
sync_job_cron_trigger
app_envstring

The deployment environment that wrote the log.

Example: production
Possible values:
productionstaging
environment_idstring · uuid

The Truto environment in which the log was generated.

Example: 1ba1f401-7183-47c5-9e39-e8e257e3c795
log_typestring
Example: sync_job_cron_trigger
Possible values:
sync_job_cron_trigger
logsstring[]

Internal log messages captured during request/job processing.

Example: ["Token still valid — no refresh needed"]
messagestring

Human-readable summary of the log event.

Example: 2026-05-16T06:28:27.040Z INFO 86.48.10.39 (9fc8527ebf27a066) GET https://api.truto.one/unified/crm/contacts 200
servicestring

The service that generated the log.

Example: truto-api
timestampstring · date-time

The time at which the log entry was recorded.

Example: 2026-05-16T06:28:27.040Z
truto logs --log-type unified_proxy_api -o json
import Truto from '@truto/truto-ts-sdk';

const truto = new Truto({
  token: '<your_api_token>',
});

for await (const item of truto.log.list()) {
  console.log(item);
}
import asyncio
from truto_python_sdk import TrutoApi

truto_api = TrutoApi(token="<your_api_token>")

async def main():
    async for item in truto_api.logs.list():
        print(item)

asyncio.run(main())
curl -X GET 'https://api.truto.one/log' \
  -H 'Authorization: Bearer <your_api_token>' \
  -H 'Content-Type: application/json'
const response = await fetch('https://api.truto.one/log', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer <your_api_token>',
    'Content-Type': 'application/json',
  },
});

const data = await response.json();
console.log(data);
import requests

url = "https://api.truto.one/log"
headers = {
    "Authorization": "Bearer <your_api_token>",
    "Content-Type": "application/json",
}
params = {
}

response = requests.get(url, headers=headers, params=params)
print(response.json())