{
  "info": {
    "name": "Human Approval - HITL Platform — mcp.ai",
    "description": "REST API for the Human Approval - HITL Platform MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/hitl",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "hitl_cancel_approval_request",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/cancel/approval/request",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "cancel",
            "approval",
            "request"
          ]
        },
        "description": "Irreversibly cancel a pending approval request so reviewers can no longer complete it. The request remains in history with cancelled status.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"request_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "hitl_create_approval_request",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/approval/request",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "approval",
            "request"
          ]
        },
        "description": "Create and broadcast one human approval request to active members of an owned loop, consuming one provider request allowance.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"content\": {},\n  \"context\": {},\n  \"loop_id\": \"\",\n  \"priority\": \"\",\n  \"response\": {},\n  \"callback_url\": \"\",\n  \"request_text\": \"\",\n  \"processing_type\": \"\",\n  \"timeout_seconds\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "hitl_create_loop",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/loop",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "loop"
          ]
        },
        "description": "Create an approval loop and return its loop ID and human invitation links; the connected account is added as an active member.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"icon\": \"\",\n  \"name\": \"\",\n  \"description\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "hitl_delete_loop",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/loop",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "loop"
          ]
        },
        "description": "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.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"loop_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "hitl_get_account_status",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/account/status",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "account",
            "status"
          ]
        },
        "description": "Return the connected HITL account identity, status, permissions, and provider-reported request allowance before creating an approval request.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "hitl_get_approval_request",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/approval/request",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "approval",
            "request"
          ]
        },
        "description": "Get the current status, configuration, and human response for one approval request; use for deliberate polling after creation.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"request_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "hitl_list_approval_requests",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/approval/requests",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "approval",
            "requests"
          ]
        },
        "description": "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.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"loop_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "hitl_list_loop_members",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/loop/members",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "loop",
            "members"
          ]
        },
        "description": "Return a loop's active and pending human reviewers so an agent can verify readiness before broadcasting an approval request.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"loop_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "hitl_list_loops",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/loops",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "loops"
          ]
        },
        "description": "Return all approval loops owned by the connected account, including embedded members and membership counts.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "hitl_update_loop",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/loop",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "loop"
          ]
        },
        "description": "Update one or more display fields of an owned approval loop without changing its members or requests.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"icon\": \"\",\n  \"name\": \"\",\n  \"loop_id\": \"\",\n  \"description\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}