Activity Logs
Activity Logs give you a searchable, time-ordered record of everything that has happened in your Ventryx organization — API requests, workflow runs, event emissions, team actions, and more.
What is logged
| Log type | Description |
|---|---|
| API requests | Every inbound request: method, path, status, latency, key used |
| Workflow runs | Start, step execution, completion, and failure for every run |
| Events | Each event emitted: type, payload summary, routing outcome |
| Webhook deliveries | Each outbound delivery attempt: URL, status code, retries |
| Team actions | Invitations, role changes, logins, key creation |
Searching logs
Filter logs by any combination of type, time range, status code, resource ID, or API key. The dashboard provides a live search interface; the API gives you programmatic access:
Search failed API requests in the last hour
GET /v1/logs?type=api_request&status=5xx&from=now-1h
Find all runs for a specific workflow
GET /v1/logs?type=workflow_run&resource_id=wf_01HXYZ&limit=50
Log entry format
{
"id": "log_01HXYZ",
"type": "api_request",
"timestamp": "2026-04-03T09:15:00.123Z",
"method": "POST",
"path": "/v1/events",
"status": 200,
"latency_ms": 28,
"api_key_id": "key_01HABC",
"request_id": "req_01HDEF"
}
Streaming logs
Stream activity logs in real time to your observability stack using a log drain. Supported destinations include Datadog, Splunk, Elastic, and any HTTP endpoint. See Observability for configuration details.