Query conversation logs
Returns authorized conversation logs for a time range. Select returned fields, export CSV, or filter any log field with query names such as duration__gte, eventType__in, or metadata.status__icontains. Supported suffixes are eq, ne, gt, gte, lt, lte, in, nin, contains, icontains, startswith, istartswith, endswith, iendswith, regex, iregex, isnull, isset, empty, notempty, and present. Without a suffix, a field uses exact matching.
Authorizations
Vida API Token
Query Parameters
Start time as Unix seconds. Defaults to Unix epoch (Jan 1 1970 00:00:00 UTC).
End time as Unix seconds. Defaults to current time.
Comma separated list of fields to include. Restricted fields are always removed.
Response format. json returns a JSON envelope. csv streams a CSV file.
json, csv Page size for pagination. Max 10000. Defaults to 20.
1 <= x <= 10000Page number starting at 1. Defaults to 1.
x >= 1When truthy, include an inferred schema array in the JSON response.
Selected account whose conversation logs should be returned. Include this when the API token can access more than one account.
Match fields against one task-goal evaluation in the log outcomes array. Supply a URL-encoded JSON object followed by ||json.
Replace field with a log field name and suffix with a supported comparison. Values may use an explicit ||json, ||bool, ||number, ||null, or ||string type hint. Repeat this pattern for each filter.
Response
Successful JSON response. When format=csv, a CSV file is streamed with status 200.
true
"Success"
Array of log entries with restricted fields removed based on caller scope.
20
5231
Returned only when includeFields is truthy. The inferred list of available fields.