API · Automation

Fire Workflow Manually

تشغيل يدوي مع بيانات اختيارية كـ triggerData.

POST/api/automation/workflows/:id/fire🔒 Bearer JWT

Body

الـ body بالكامل يصبح {{triggerData}} داخل الـ workflow. شكل حر — أنت تتحكّم.

الحقل	النوع	الوصف
`*`	`any`	أي JSON. يُمرَّر للـ workflow كـ `triggerData`.

مثال طلب

curl -X POST https://operix.operixdigital.com/api/automation/workflows/clx123/fire \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "source": "manual",
    "client": { "id": "c_456", "name": "أحمد" }
  }'

مثال استجابة

{ "runId": "run_abc123def" }

استخدم الـ runId مع GET /api/automation/runs/:idلمتابعة الحالة.

سلوك

التنفيذ غير متزامن — الاستجابة فورية حتى لو الـ workflow كبير. كل التنفيذ يحدث في BullMQ workflow-runs queue.

Errors

الكود	الرسالة	السبب
400	`Workflow is not active`	فعّل الـ workflow أولاً عبر PATCH.
401	`Unauthorized`
404	`Workflow not found`