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, webhook or rapid_bridge.

eventstring

Filter webhook logs by event. Use when log_type is webhook. Matches the event_type field on the returned rows.

integrated_account_idstring

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

integrationstring

Filter logs by integration slug. Use when log_type is unified_proxy_api, rapid_bridge or webhook.

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.

sync_job_idstring

Filter RapidBridge logs by sync job ID. Use when log_type is rapid_bridge.

sync_job_run_eventstring

Filter RapidBridge logs by sync job run event (e.g. record_error, failed). Use when log_type is rapid_bridge.

sync_job_run_idstring

Filter RapidBridge logs to a single sync job run. Use when log_type is rapid_bridge to fetch a run's execution logs, including the failure cause of a failed run (the failure reason is logged here, not stored on the run row).

tool_namestring

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

webhook_idstring

Filter logs by webhook ID. Use when log_type is webhook or rapid_bridge.

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 that wrote the log (production, staging, staging2, thoropass-production, and per-developer preview deployments). Distinct from environment_id, which is the Truto environment the log belongs to: a single environment_id can be served by more than one deployment, and app_env is what tells them apart. Not an enumerated set — new deployments add values.

Example: production
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. On mcp rows the token segment is masked in full, so the value is always /mcp/[redacted] and identifies nothing — use mcp_server_id / mcp_server_name instead.

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 · 20 properties
app_envstring

The deployment that wrote the log (production, staging, staging2, thoropass-production, and per-developer preview deployments). Distinct from environment_id, which is the Truto environment the log belongs to: a single environment_id can be served by more than one deployment, and app_env is what tells them apart. Not an enumerated set — new deployments add values.

Example: production
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
fetch_durationnumber

Time in milliseconds spent fetching data from the upstream API for this sync step.

Example: 50
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

Ambiguous by design — this stream is written by two loggers. On a row emitted by the Durable Object's own logger (the fetch entrypoint) this is the HTTP verb the object was invoked with (PUT, DELETE). On a per-request row (the bulk of the stream) it is the Truto method executed by that sync step (list, get, create, ...), and is paired with resource. Rows emitted by the alarm entrypoint carry no method at all.

Example: list
num_recordsinteger

The number of records produced by this sync step.

Example: 100
resourcestring

The resource this sync step fetched or transformed.

Example: contacts
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. This is the field that carries run outcome on this log type — there is no status field on these rows.

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
versioninteger

The sync-job runtime version that produced the run.

Example: 4
Possible values:
1234
webhook_idstring · uuid

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

webhook_statusinteger

The HTTP status code returned when the sync job posted to its configured webhook. Unrelated to the outcome of the run itself.

Example: 200
webhook · 15 properties
app_envstring

The deployment that wrote the log (production, staging, staging2, thoropass-production, and per-developer preview deployments). Distinct from environment_id, which is the Truto environment the log belongs to: a single environment_id can be served by more than one deployment, and app_env is what tells them apart. Not an enumerated set — new deployments add values.

Example: production
durable_objectstring

The Durable Object class that emitted the log.

Example: webhook_delivery
Possible values:
webhook_delivery
environment_idstring · uuid

The Truto environment in which the log was generated.

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

The event that triggered the webhook delivery. Filter on it with the event key of log_type_filter.

Example: sync_job_run:created
integrated_account_idstring · uuid

The integrated account the event originated from, when the payload identifies one.

integrationstring

The integration slug the event originated from, when the payload identifies one.

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
methodstring

Which delivery path emitted the row — deliver for the first attempt, alarm for a scheduled retry. This is not a Truto API method.

Example: deliver
Possible values:
deliveralarm
servicestring

The service that generated the log.

Example: truto-api
statusstring

Only ever set to error, on a failed or skipped delivery. Absent on a successful delivery — read webhook_endpoint_status for the endpoint's response code.

Example: error
Possible values:
error
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. Absent for connection-level failures, where no HTTP response was received.

Example: 200
webhook_idstring · uuid

The webhook configuration that fired.

mcp · 36 properties
app_envstring

The deployment that wrote the log (production, staging, staging2, thoropass-production, and per-developer preview deployments). Distinct from environment_id, which is the Truto environment the log belongs to: a single environment_id can be served by more than one deployment, and app_env is what tells them apart. Not an enumerated set — new deployments add values.

Example: production
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. On mcp rows the token segment is masked in full, so the value is always /mcp/[redacted] and identifies nothing — use mcp_server_id / mcp_server_name instead.

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 · 12 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 that wrote the log (production, staging, staging2, thoropass-production, and per-developer preview deployments). Distinct from environment_id, which is the Truto environment the log belongs to: a single environment_id can be served by more than one deployment, and app_env is what tells them apart. Not an enumerated set — new deployments add values.

Example: production
durationnumber

Time in milliseconds Truto spent handling the alarm tick.

Example: 180
entity_idstring · uuid

The sync job cron trigger whose alarm fired.

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

The Truto environment in which the log was generated.

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

The HTTP method of the internal alarm delivery. Always POST.

Example: POST
http_status_codeinteger

The status Truto returned for the internal alarm delivery. 200 means the tick was accepted and a sync job run was created.

Example: 200
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())