# Human Approval - HITL Platform

```json
{
  "name": "Human Approval - HITL Platform",
  "slug": "hitl",
  "url": "https://composio.dev/toolkits/hitl",
  "markdown_url": "https://composio.dev/toolkits/hitl.md",
  "logo_url": "https://logos.composio.dev/api/hitl",
  "categories": [
    "workflow automation"
  ],
  "is_composio_managed": false,
  "updated_at": "2026-08-20T15:32:22.572Z"
}
```

![Human Approval - HITL Platform logo](https://logos.composio.dev/api/hitl)

## Description

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Human Approval - HITL Platform MCP or direct API to request approvals, submit reviews, pause agent loops, and capture human decisions through natural language.

## Summary

Human Approval - HITL Platform is a HITL.sh service for adding human approval and review workflows to AI agents.
Use it to pause risky automations, collect structured decisions, and resume safely.

## Categories

- workflow automation

## Toolkit Details

- Tools: 10

## Images

- Logo: https://logos.composio.dev/api/hitl

## Authentication

- **Api Key**
  - Type: `api_key`
  - Description: Api Key authentication for Human Approval - HITL Platform.
  - Setup:
    - Configure Api Key credentials for Human Approval - HITL Platform.
    - Use the credentials when creating an auth config in Composio.

## Suggested Prompts

- Approve vendor payment before agent continues
- Review outbound email before sending
- Escalate risky deployment for human review

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `HITL_CANCEL_APPROVAL_REQUEST` | Cancel Approval Request | Irreversibly cancel a pending approval request so reviewers can no longer complete it. The request remains in history with cancelled status. |
| `HITL_CREATE_APPROVAL_REQUEST` | Create Approval Request | Create and broadcast one human approval request to active members of an owned loop, consuming one provider request allowance. |
| `HITL_CREATE_LOOP` | Create Loop | Create an approval loop and return its loop ID and human invitation links; the connected account is added as an active member. |
| `HITL_DELETE_LOOP` | 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. |
| `HITL_GET_ACCOUNT_STATUS` | Get Account Status | Return the connected HITL account identity, status, permissions, and provider-reported request allowance before creating an approval request. |
| `HITL_GET_APPROVAL_REQUEST` | Get Approval Request | Get the current status, configuration, and human response for one approval request; use for deliberate polling after creation. |
| `HITL_LIST_APPROVAL_REQUESTS` | 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. |
| `HITL_LIST_LOOP_MEMBERS` | List Loop Members | Return a loop's active and pending human reviewers so an agent can verify readiness before broadcasting an approval request. |
| `HITL_LIST_LOOPS` | List Loops | Return all approval loops owned by the connected account, including embedded members and membership counts. |
| `HITL_UPDATE_LOOP` | Update Loop | Update one or more display fields of an owned approval loop without changing its members or requests. |

## Supported Triggers

None listed.

## Installation and MCP Setup

### Path 1: SDK Installation

#### Path 1, Step 1: Install Composio

Install the Composio SDK
```python
pip install composio_openai
```

```typescript
npm install @composio/openai
```

#### Path 1, Step 2: Initialize Composio and Create Tool Router Session

Import and initialize Composio client, then create a Tool Router session
```python
from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider

composio = Composio(provider=OpenAIResponsesProvider())
openai = OpenAI()
session = composio.create(user_id='your-user-id')
```

```typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
```

#### Path 1, Step 3: Execute Human Approval - HITL Platform Tools via Tool Router with Your Agent

Get tools from Tool Router session and execute Human Approval - HITL Platform actions with your Agent
```python
tools = session.tools
response = openai.responses.create(
  model='gpt-4.1',
  tools=tools,
  input=[{
    'role': 'user',
    'content': 'Create a human approval request to review a $5,000 vendor payment before the agent continues'
  }]
)
result = composio.provider.handle_tool_calls(
  response=response,
  user_id='your-user-id'
)
print(result)
```

```typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'Create a human approval request to review a $5,000 vendor payment before the agent continues'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
```

### Path 2: MCP Server Setup

#### Path 2, Step 1: Install Composio

Install the Composio SDK for Python or TypeScript
```python
pip install composio claude-agent-sdk
```

```typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
```

#### Path 2, Step 2: Initialize Client and Create Tool Router Session

Import and initialize the Composio client, then create a Tool Router session for Human Approval - HITL Platform
```python
from composio import Composio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

composio = Composio(api_key='your-composio-api-key')
session = composio.create(user_id='your-user-id')
url = session.mcp.url
```

```typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });
const session = await composio.create('your-user-id');
console.log(`Tool Router session created: ${session.mcp.url}`);
```

#### Path 2, Step 3: Connect to AI Agent

Use the MCP server with your AI agent (Anthropic Claude or Mastra)
```python
import asyncio

options = ClaudeAgentOptions(
    permission_mode='bypassPermissions',
    mcp_servers={
        'tool_router': {
            'type': 'http',
            'url': url,
            'headers': {
                'x-api-key': 'your-composio-api-key'
            }
        }
    },
    system_prompt='You are a helpful assistant with access to Human Approval - HITL Platform tools.',
    max_turns=10
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query('Create a human approval request to review a $5,000 vendor payment before the agent continues')
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'text'):
                        print(block.text)

asyncio.run(main())
```

```typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: session.mcp.url,
    headers: {
      'x-api-key': 'your-composio-api-key',
    },
  },
});

const tools = await client.tools();
const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{
    role: 'user',
    content: 'Create a human approval request to review a $5,000 vendor payment before the agent continues'
  }],
  maxSteps: 5,
});

console.log(`Agent: ${text}`);
```

## Why Use Composio?

### 1. AI Native Human Approval - HITL Platform Integration

- Supports both Human Approval - HITL Platform MCP and direct API based integrations
- Structured, LLM-friendly schemas for reliable approval and review requests
- Rich coverage for creating approval loops, submitting review details, and querying human decisions

### 2. Managed Auth

- Secure API key handling so your agents don't need hard-coded HITL.sh credentials
- Central place to manage, scope, and revoke Human Approval - HITL Platform access
- Per user and per environment credentials for safer approval workflows

### 3. Agent Optimized Design

- Tools are tuned for clear approval prompts, structured review payloads, and reliable continuation after human input
- Comprehensive execution logs so you always know what approval was requested, when, and on whose behalf

### 4. Enterprise Grade Security

- Fine-grained RBAC so you control which agents and users can access Human Approval - HITL Platform
- Scoped, least privilege access to approval and review workflows
- Full audit trail of agent actions to support governance, review, and compliance

## Use Human Approval - HITL Platform with any AI Agent Framework

Choose a framework you want to connect Human Approval - HITL Platform with:

None listed.

## Related Toolkits

- [0CodeKit](https://composio.dev/toolkits/0codekit) - 0CodeKit is a utility API platform for AI, document, image, and data workflows. Use it to convert, validate, generate, store, and automate data without custom backend code.
- [Airtop](https://composio.dev/toolkits/airtop) - Airtop is a cloud browser platform for AI-powered web automation. Use it to navigate sites, extract data, and run reusable browser workflows.
- [Apify MCP](https://composio.dev/toolkits/apify_mcp) - Apify MCP is the official MCP server for Apify's web scraping and browser automation platform. Use it to run actors, collect structured web data, and automate crawling workflows.
- [Apilio](https://composio.dev/toolkits/apilio) - Apilio is a home automation platform that lets you connect and control smart devices from different brands. It helps you build flexible automations with complex conditions, schedules, and integrations.
- [Basin](https://composio.dev/toolkits/basin) - Basin is a no-code form backend for quickly setting up reliable contact forms. It lets you collect and manage form submissions without writing any server-side code.
- [Bika.ai](https://composio.dev/toolkits/bika) - Bika.ai is an AI automation database platform for managing spaces, teams, records, automations, and outgoing webhooks. It helps teams organize structured data and automate database-driven workflows in one place.
- [Bouncer](https://composio.dev/toolkits/bouncer) - Bouncer is an email validation platform that verifies the authenticity of email addresses in real-time and batch. It helps boost deliverability and reduce bounce rates for your communications.
- [Celigo](https://composio.dev/toolkits/celigo) - Celigo is an integration platform as a service for connecting apps, data, and business workflows. It helps teams automate cross-system processes without building every integration from scratch.
- [Conveyor](https://composio.dev/toolkits/conveyor) - Conveyor is a platform that automates security reviews with a Trust Center and AI-driven questionnaire automation. It streamlines compliance and vendor security processes for faster, hassle-free reviews.
- [Cronfree Time Scheduler](https://composio.dev/toolkits/cronfree_time_scheduler) - Cronfree Time Scheduler is an API-based scheduler for recurring webhook calls. Use it to create and remove timezone-aware schedules without running cron.
- [Crowdin](https://composio.dev/toolkits/crowdin) - Crowdin is a localization management platform that streamlines translation workflows and collaboration. It helps teams centralize multilingual content, boost productivity, and automate translation processes.
- [Databox](https://composio.dev/toolkits/databox) - Databox is a business analytics platform that connects your data from any tool and device. It helps you track KPIs, build dashboards, and discover actionable insights.
- [Detrack](https://composio.dev/toolkits/detrack) - Detrack is a delivery management platform for real-time tracking and proof of delivery. It helps businesses automate notifications and keep customers updated every step of the way.
- [Digital Humani](https://composio.dev/toolkits/digital_humani) - Digital Humani is a reforestation API for browsing planting projects, submitting tree requests, and tracking planted trees. It helps teams connect climate action directly to products, campaigns, and customer experiences.
- [Dnsfilter](https://composio.dev/toolkits/dnsfilter) - Dnsfilter is a cloud-based DNS security and content filtering solution. It helps organizations block online threats and manage safe internet access with ease.
- [EnforcedFlow](https://composio.dev/toolkits/enforcedflow) - EnforcedFlow is a work routing platform for advanced round-robin groups, agent criteria, availability, and email assignments. It helps teams distribute work fairly and quickly using configurable assignment rules.
- [Faraday](https://composio.dev/toolkits/faraday) - Faraday lets you embed AI in workflows across your stack for smarter automation. It boosts your favorite tools with actionable intelligence and seamless integration.
- [Feathery](https://composio.dev/toolkits/feathery) - Feathery is an AI-powered platform for building dynamic data intake forms with advanced logic. It helps teams automate complex workflows and collect structured data with ease.
- [Fillout forms](https://composio.dev/toolkits/fillout_forms) - Fillout forms is an online platform for building and managing forms with a flexible API. It lets you create, distribute, and collect responses from forms with ease.
- [Formcrafts](https://composio.dev/toolkits/formcrafts) - Formcrafts is an online form builder for creating forms, collecting responses, and managing uploads. Use it to centralize form data and files across your organization.

## Frequently Asked Questions

### Do I need my own developer credentials to use Human Approval - HITL Platform with Composio?

Yes, Human Approval - HITL Platform requires you to configure your own API key. Once set up, Composio handles secure credential storage and API request handling for you.

### Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. [Learn more](https://docs.composio.dev/tool-router/overview).

### Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. [Learn more](https://trust.composio.dev).

### What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)