> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Human Approval - HITL Platform

> HITL.sh adds human approval and review workflows to AI agents and automations through loops and structured requests.

![Human Approval - HITL Platform logo](https://mintcdn.com/composio-preview/o1IUBrrsmtgkhmyf/images/toolkits/hitl.svg?fit=max\&auto=format\&n=o1IUBrrsmtgkhmyf\&q=85\&s=a7dac8b9562f7ec181d225ff4ec7a144)

* **Category:** ai agents
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 10
* **Triggers:** 0
* **Slug:** `HITL`
* **Version:** 20261030\_00

## Tools

> [accordion] Cancel Approval Request
>
> **Slug:** `HITL_CANCEL_APPROVAL_REQUEST`
>
> Irreversibly cancel a pending approval request so reviewers can no longer complete it. The request remains in history with cancelled status.
>
> #### Input Parameters
>
> **request\_id** `string` *required*
>
> 24-character hexadecimal ID of the pending approval request to cancel. Completed, timed-out, or already-cancelled requests cannot be cancelled.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Approval Request
>
> **Slug:** `HITL_CREATE_APPROVAL_REQUEST`
>
> Create and broadcast one human approval request to active members of an owned loop, consuming one provider request allowance.
>
> #### Input Parameters
>
> **content** `string` *required*
>
> Content attached to the request, selected by its type field.
>
> **context** `object`
>
> Optional JSON object with task context for the approver and response correlation.
>
> **loop\_id** `string` *required*
>
> 24-character hexadecimal ID of the owned loop whose active members should receive the request.
>
> **priority** `string ("low" | "medium" | "high" | "critical")`
>
> Urgency shown to reviewers.
>
> **response** `string` *required*
>
> Expected human response, type-specific configuration, and compatible fallback value.
>
> **callback\_url** `string`
>
> Optional HTTPS endpoint for completed, timeout, or cancelled events. Validate and deduplicate events because HITL documents no webhook signature.
>
> **request\_text** `string` *required*
>
> Question or review instructions shown to the human approver (1-2000 characters).
>
> **processing\_type** `string ("deferred" | "time-sensitive")`
>
> Use deferred for a long-lived request or time-sensitive with an explicit timeout.
>
> **timeout\_seconds** `integer`
>
> Required for time-sensitive requests and optional for deferred requests; seconds before timeout (60-86400).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Loop
>
> **Slug:** `HITL_CREATE_LOOP`
>
> Create an approval loop and return its loop ID and human invitation links; the connected account is added as an active member.
>
> #### Input Parameters
>
> **icon** `string` *required*
>
> HITL icon identifier or emoji displayed for the loop (maximum 100 characters).
>
> **name** `string` *required*
>
> Loop name shown to reviewers (1-100 characters).
>
> **description** `string`
>
> Optional purpose or instructions for the loop (maximum 500 characters).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Loop
>
> **Slug:** `HITL_DELETE_LOOP`
>
> Permanently 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
>
> **loop\_id** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Account Status
>
> **Slug:** `HITL_GET_ACCOUNT_STATUS`
>
> Return the connected HITL account identity, status, permissions, and provider-reported request allowance before creating an approval request.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Approval Request
>
> **Slug:** `HITL_GET_APPROVAL_REQUEST`
>
> Get the current status, configuration, and human response for one approval request; use for deliberate polling after creation.
>
> #### Input Parameters
>
> **request\_id** `string` *required*
>
> 24-character hexadecimal ID of the approval request to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Approval Requests
>
> **Slug:** `HITL_LIST_APPROVAL_REQUESTS`
>
> Return 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
>
> **loop\_id** `string`
>
> Optional 24-character hexadecimal loop ID. When provided, list only that loop's requests using the dedicated loop endpoint.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Loop Members
>
> **Slug:** `HITL_LIST_LOOP_MEMBERS`
>
> Return a loop's active and pending human reviewers so an agent can verify readiness before broadcasting an approval request.
>
> #### Input Parameters
>
> **loop\_id** `string` *required*
>
> 24-character hexadecimal ID of the loop whose members to list.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Loops
>
> **Slug:** `HITL_LIST_LOOPS`
>
> Return all approval loops owned by the connected account, including embedded members and membership counts.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Loop
>
> **Slug:** `HITL_UPDATE_LOOP`
>
> Update one or more display fields of an owned approval loop without changing its members or requests.
>
> #### Input Parameters
>
> **icon** `string`
>
> New HITL icon identifier or emoji (maximum 100 characters).
>
> **name** `string`
>
> New loop name (1-100 characters).
>
> **loop\_id** `string` *required*
>
> 24-character hexadecimal ID of the loop to update.
>
> **description** `string`
>
> New loop description (maximum 500 characters); pass an empty string to clear it.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
