Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.medera.info/llms.txt

Use this file to discover all available pages before exploring further.

Canvas workflows are semver-versioned. Publishing creates an immutable snapshot in agent_workflow_versions and triggers an automatic sandbox deployment.

​
Tables

TableMigrationPurpose
agent_workflows061 / 110 / 130Current draft + status + lock_version for optimistic concurrency
agent_workflow_versions110Immutable per-version snapshot (nodes, connections, variables, settings)
agent_workflow_executions110Per-execution trace + trigger_type (canvas_test / api / scheduled / webhook)
workflow_approvals111user-approval pauses persist here for human review
workflow_schedules112 / 133Cron-driven scheduled triggers
agent_deployments138 / 151 / 152Runtime deployments — environment, status, snapshots, URLs, auto-rollback config
agent_links141Shareable canonical URL per deployment (org_slug, agent_slug, version_number)
agent_calls142Per-call tracking against a deployment
agent_call_function_logs143High-volume per-function-invocation log (BIGSERIAL)
deployment_preview_access144Token-based sandbox sharing
deployment_audit_log140 / 145WORM-style immutable audit of every deployment event
deployment_metrics148Time-bucketed call / latency / error metrics
deployment_alerts149Threshold-based alerting + resolution

​
Deployment lifecycle

pending → deploying → running → testing → passed | failed
                                       └→ promoting → promoted
                                       └→ stopping  → stopped | expired | rolled_back
  • Sandbox URL: https://sandbox.medera.info/{org_slug}/{agent_slug}-v{version}
  • Production URL: https://agents.medera.info/{org_slug}/{agent_slug}
  • Sandbox auto-expiry: auto_expire_at is set 72 h after deploy; expirePreviewTokens cron runs daily at 3 AM

​
Auto-rollback

agent_deployments.auto_rollback_config declares thresholds (error rate, p95 latency, alert severity). When triggered, the deployment rolls back to the previous successful version and writes an event_type='rolled_back' row to deployment_audit_log.

​
WORM audit

deployment_audit_log is an append-only table. UPDATE and DELETE are blocked by triggers (migration 145 fixed the FK from RESTRICT → SET NULL to preserve WORM semantics when actors are deleted).