Appearance

List Logs ​

You can use this endpoint to list all the Unified, Proxy, Webhook and RapidBridge logs for your Truto account.

Time Range Filtering ​

You can filter logs by time range using the created_at query parameter. This parameter accepts an object with gt (greater than) and lt (less than) properties, both in ISO format.

  • If created_at[gt] is provided, created_at[lt] must also be provided
  • The time range between created_at[gt] and created_at[lt] cannot exceed 1 month
  • If created_at[lt] is not provided, it defaults to the current time
  • If created_at[gt] is not provided, no time range filtering is applied

Example:

json
  "created_at": {
    "gt": "2024-03-01T00:00:00.000Z",
    "lt": "2024-03-15T00:00:00.000Z"
  }
} ```


## Endpoint <Badge v-if="isDeprecated" type="warning">Deprecated</Badge>

```http-vue
{{apiData.method.toUpperCase()}} {{ apiData.path }}

Query parameters ​

Refer Specifying query parameters in Truto APIs

log_type
string
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.

All possible enum values:
  • unified_proxy_api
  • rapid_bridge
  • webhook
  • mcp
  • sync_job_cron_trigger
created_at
object

The date-time range to filter the logs by.

gt
string · 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
lt
string · date-time

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

Example: 2021-10-01T00:00:00Z
limit
number

The number of logs to return. Default is 100.

next_cursor
string

The cursor to get the next set of logs.

log_type_filter
object

The filters to apply to fetch only specific logs.

request_type
string

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

All possible enum values:
  • proxy
  • unified
integrated_account_id
string

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

environment_id
string

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

mcp_server_id
string

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

mcp_method
string

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

All possible enum values:
  • initialize
  • notifications/initialized
  • tools/list
  • tools/call
  • prompts/list
  • resources/list
  • ping
tool_name
string

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

resource
string

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

method
string

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

client_name
string

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

client_version
string

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

request_id
string

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

Response Body ​

result
array

The list of logs.

next_cursor
string

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