Skip to main content
Human Approval - HITL Platform logo
  • Category: ai agents
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 10
  • Triggers: 0
  • Slug: HITL
  • Version: 20261030_00

Tools

Slug: HITL_CANCEL_APPROVAL_REQUESTIrreversibly cancel a pending approval request so reviewers can no longer complete it. The request remains in history with cancelled status.

Input Parameters

string
required
24-character hexadecimal ID of the pending approval request to cancel. Completed, timed-out, or already-cancelled requests cannot be cancelled.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HITL_CREATE_APPROVAL_REQUESTCreate and broadcast one human approval request to active members of an owned loop, consuming one provider request allowance.

Input Parameters

string
required
Content attached to the request, selected by its type field.
object
Optional JSON object with task context for the approver and response correlation.
string
required
24-character hexadecimal ID of the owned loop whose active members should receive the request.
string ("low" | "medium" | "high" | "critical")
Urgency shown to reviewers.
string
required
Expected human response, type-specific configuration, and compatible fallback value.
string
Optional HTTPS endpoint for completed, timeout, or cancelled events. Validate and deduplicate events because HITL documents no webhook signature.
string
required
Question or review instructions shown to the human approver (1-2000 characters).
string ("deferred" | "time-sensitive")
Use deferred for a long-lived request or time-sensitive with an explicit timeout.
integer
Required for time-sensitive requests and optional for deferred requests; seconds before timeout (60-86400).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HITL_CREATE_LOOPCreate an approval loop and return its loop ID and human invitation links; the connected account is added as an active member.

Input Parameters

string
required
HITL icon identifier or emoji displayed for the loop (maximum 100 characters).
string
required
Loop name shown to reviewers (1-100 characters).
string
Optional purpose or instructions for the loop (maximum 500 characters).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HITL_DELETE_LOOPPermanently delete an owned loop and all of its memberships, approval requests, responses, feedback, and analytics. This cascading deletion erases the loop’s entire history and cannot be undone.

Input Parameters

string
required
24-character hexadecimal ID of the loop to permanently delete. Use only for a loop whose memberships, approval requests, responses, feedback, analytics, and entire history may be erased.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HITL_GET_ACCOUNT_STATUSReturn the connected HITL account identity, status, permissions, and provider-reported request allowance before creating an approval request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HITL_GET_APPROVAL_REQUESTGet the current status, configuration, and human response for one approval request; use for deliberate polling after creation.

Input Parameters

string
required
24-character hexadecimal ID of the approval request to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HITL_LIST_APPROVAL_REQUESTSReturn approval requests created by the connected API key, optionally restricted to one loop; pagination controls are omitted because the live API currently ignores them.

Input Parameters

string
Optional 24-character hexadecimal loop ID. When provided, list only that loop’s requests using the dedicated loop endpoint.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HITL_LIST_LOOP_MEMBERSReturn a loop’s active and pending human reviewers so an agent can verify readiness before broadcasting an approval request.

Input Parameters

string
required
24-character hexadecimal ID of the loop whose members to list.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HITL_LIST_LOOPSReturn all approval loops owned by the connected account, including embedded members and membership counts.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HITL_UPDATE_LOOPUpdate one or more display fields of an owned approval loop without changing its members or requests.

Input Parameters

string
New HITL icon identifier or emoji (maximum 100 characters).
string
New loop name (1-100 characters).
string
required
24-character hexadecimal ID of the loop to update.
string
New loop description (maximum 500 characters); pass an empty string to clear it.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not