Skip to main content
GET
/
v1
/
workflows
/
runs
/
{run_id}
/
hil-decisions
/
{block_id}
from retab import Retab

client = Retab()

decision = client.workflows.runs.get_hil_decision(
    run_id="run_abc123",
    block_id="hil-1",
)

print(decision.decision_received, decision.decision_applied, decision.approved)

{
  "run_id": "run_abc123",
  "block_id": "hil-1",
  "block_status": "waiting_for_hil",
  "decision_received": true,
  "decision_applied": false,
  "approved": true,
  "modified_data": { "amount": 1234.56 },
  "payload_hash": "sha256-abc",
  "received_at": "2026-05-01T14:30:00Z",
  "applied_at": null
}

Documentation Index

Fetch the complete documentation index at: https://docs.retab.com/llms.txt

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

Get Temporal-owned decision state for a single human-in-the-loop block 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 block 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. 
from retab import Retab

client = Retab()

decision = client.workflows.runs.get_hil_decision(
    run_id="run_abc123",
    block_id="hil-1",
)

print(decision.decision_received, decision.decision_applied, decision.approved)

{
  "run_id": "run_abc123",
  "block_id": "hil-1",
  "block_status": "waiting_for_hil",
  "decision_received": true,
  "decision_applied": false,
  "approved": true,
  "modified_data": { "amount": 1234.56 },
  "payload_hash": "sha256-abc",
  "received_at": "2026-05-01T14:30:00Z",
  "applied_at": null
}

Authorizations

​
Api-Key
string
header
required

Path Parameters

​
run_id
string
required
​
block_id
string
required

Query Parameters

​
access_token
string | null

Response

Successful Response

​
run_id
string
required

Workflow run ID

​
block_id
string
required

HIL block ID

​
block_status
string | null

Current workflow block status

​
decision_received
boolean
default:false

Whether Temporal has durably received a HIL decision for this block

​
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