Human Approvals - HITL Platform icon

Human Approvals - HITL Platform

Create human-in-the-loop decision requests and wait for human responses

Request → Send and Wait

AI-generated

Summary

Sends a human-in-the-loop request and polls the API until a human response is received, a timeout occurs, or the request is cancelled, returning structured response data with timing and metadata.

Inputs

  • loopId (required) — Choose from the list, or specify an ID using an expression
  • processingType (required) — Type of request processing
  • timeoutSeconds — Timeout in seconds for time-sensitive requests (60-86400)
  • contentType (required) — Type of content in the request
  • requestText (required) — The question or task for the human to respond to
  • imageUrl (required) — URL of image to include with the request
  • priority (required) — Priority level for the request
  • responseType (required) — Type of response expected from the human
  • defaultResponse (required) — Default response if request times out or fails
  • additionalFields — Optional additional context data for the request (JSON format)
  • responseOptions — Comma-separated options (e.g., 'Yes,No,Maybe')
  • ratingMin — Minimum rating value
  • ratingMax — Maximum rating value

Output shape

object containing request_id, status, response, response_by, response_time_seconds, message, wait_info, polling_used, polling_duration_ms, full_response, and original_request

Polling occurs every 5 seconds until status is completed/answered/resolved/failed/timeout/cancelled or response_data is present. Returns default_response if timeout or failure occurs.

Links

Discussion