​

Interactive workflows for Shieldbase Mini

1. POST /external/workflows/{group_id}/runs with {"interactive":true} and optional existing inputs/external_user fields. Retain the returned run_id. Starting is asynchronous.
2. Poll GET /external/workflows/runs/{run_id}/inputs (for example every 2 seconds, backing off on errors). waiting_inputs contains the current queue_id, opaque task_token, step, and any validation message. An empty list is not completion: inspect status and the existing run-detail endpoint for execution errors/results.
3. Ask only for the returned step. expects is form, file, choice, message, or approval. Forms expose formFields and form_sections with required, conditional, options, repeated-row and file constraints. Do not invent values. Use the existing upload API and pass resulting URLs for files. Approval must be performed by its authorized approver; this endpoint does not grant approval rights.
4. POST /external/workflows/runs/{run_id}/inputs:

{
  "queue_id": "<returned queue UUID>",
  "task_token": "<returned token>",
  "command_id": "<new UUID for this answer>",
  "answer": {"Employee Name": "BB Tan", "Purpose of Expense": "Dental claim"},
  "file_urls": {"Receipt": "https://your-upload-location/receipt.pdf"}
}