Agentic Quickstart

This quickstart shows how to publish a workflow, deploy it to sandbox, and execute it.

1. List existing workflows

curl https://api.medera.info/api/agent-workflows \
  -H "X-API-Key: $MEDERA_API_KEY"

Response includes published / draft workflows scoped to your accessible organizations.

2. Publish a workflow

curl -X POST https://api.medera.info/api/agent-workflows/{id}/publish \
  -H "X-API-Key: $MEDERA_API_KEY" \
  -d '{ "changeDescription": "Initial release" }'

Publishing snapshots the canvas into agent_workflow_versions and immediately deploys to sandbox.

3. Execute (sandbox)

curl -X POST https://api.medera.info/api/agent-workflows/{id}/execute \
  -H "X-API-Key: $MEDERA_API_KEY" \
  -d '{
    "inputValues": { "patient_id": "pat_abc" },
    "triggerType": "api",
    "mode": "async"
  }'

Response: { "executionId": "..." }. Poll status:

curl https://api.medera.info/api/agent-workflows/executions/{executionId} \
  -H "X-API-Key: $MEDERA_API_KEY"

4. Deploy to production

curl -X POST https://api.medera.info/api/agent-workflows/{id}/deploy/{version} \
  -H "X-API-Key: $MEDERA_API_KEY" \
  -d '{ "environment": "live" }'

The promotion writes a event_type='promoted' row to deployment_audit_log. Subsequent calls flow to https://agents.medera.info/{org_slug}/{agent_slug}.

​1. List existing workflows

​2. Publish a workflow

​3. Execute (sandbox)

​4. Deploy to production

1. List existing workflows

2. Publish a workflow

3. Execute (sandbox)

4. Deploy to production