Patch Changes
-
#1040
5e54d3bThanks @omeraplak! - feat: add multi-tenant filters to workflow execution listing (/workflows/executions)You can now filter workflow execution history by
userIdand metadata fields in addition to
existing filters (workflowId,status,from,to,limit,offset).What's New
- Added
userIdfilter support for workflow run queries. - Added metadata filtering support:
metadataas URL-encoded JSON objectmetadata.<key>query params (for example:metadata.tenantId=acme)
- Added status aliases for compatibility:
success->completedpending->running
- Implemented consistently across storage adapters:
- In-memory
- PostgreSQL
- LibSQL
- Supabase
- Cloudflare D1
- Managed Memory (
@voltagent/voltagent-memory)
- Updated server docs and route descriptions to include new filters.
TypeScript Example
const params = new URLSearchParams({ workflowId: "order-approval", status: "completed", userId: "user-123", "metadata.tenantId": "acme", "metadata.region": "eu", limit: "20", offset: "0", }); const response = await fetch(`http://localhost:3141/workflows/executions?${params.toString()}`); const data = await response.json();
cURL Examples
# Filter by workflow + user + metadata key curl "http://localhost:3141/workflows/executions?workflowId=order-approval&userId=user-123&metadata.tenantId=acme&status=completed&limit=20&offset=0"
# Filter by metadata JSON object (URL-encoded) curl "http://localhost:3141/workflows/executions?metadata=%7B%22tenantId%22%3A%22acme%22%2C%22region%22%3A%22eu%22%7D"
- Added
-
Updated dependencies [
5e54d3b]:- @voltagent/server-core@2.1.5
- @voltagent/core@2.3.7