Skip to main content
GET
/
v1
/
workflows
/
runs
/
{run_id}
/
hil-decisions
/
{node_id}
Get Hil Decision Route
curl --request GET \
  --url https://api.retab.com/v1/workflows/runs/{run_id}/hil-decisions/{node_id} \
  --header 'Api-Key: <api-key>'
{
  "run_id": "<string>",
  "node_id": "<string>",
  "node_status": "<string>",
  "decision_received": false,
  "decision_applied": false,
  "approved": true,
  "modified_data": {},
  "payload_hash": "<string>",
  "received_at": "2023-11-07T05:31:56Z",
  "applied_at": "2023-11-07T05:31:56Z"
}
Get Temporal-owned decision state for a single human-in-the-loop node in a workflow run. This endpoint is useful when:
  • you want to confirm whether a decision was received
  • you need to distinguish decision_received from decision_applied
  • the run projection may still be catching up after a recent submission
If the node exists but no decision has been submitted yet, the response still returns 200 with:
  • decision_received=false
  • decision_applied=false
  • approved=null
Use Submit HIL Decision to submit the decision, and Get Run to inspect the projected run state.

Authorizations

Api-Key
string
header
required

Path Parameters

run_id
string
required
node_id
string
required

Query Parameters

access_token
string | null

Response

Successful Response

run_id
string
required

Workflow run ID

node_id
string
required

HIL node ID

node_status
string | null

Current workflow node status

decision_received
boolean
default:false

Whether Temporal has durably received a HIL decision for this node

decision_applied
boolean
default:false

Whether the workflow loop has applied the received decision

approved
boolean | null

Approved/rejected decision value

modified_data
Modified Data · object

Approved payload data retained by Temporal

payload_hash
string | null

Stable identity hash for the latest decision payload

received_at
string<date-time> | null

When Temporal durably received the decision

applied_at
string<date-time> | null

When the workflow loop applied the decision