Input or files
Ask for facts or documents that are unavailable to the agent, then return typed fields and authenticated attachments.
Input, files, and approvals from people
When an agent needs information, a file, a correction, or a decision, it creates a hosted Fangst request. The person responds, and the agent continues with structured data.
Expose Fangst as REST or MCP tools. The agent can create a request when it reaches missing information during a run.
POST https://api.fang.st/v1/requests
Authorization: Bearer <FANGST_API_TOKEN>
Content-Type: application/json
{
"tool": "request_human_input",
"arguments": {
"title": "Provide supplier details",
"fields": [
{
"key": "bank_account",
"type": "text"
},
{
"key": "documentation",
"type": "file"
}
]
}
}{
"status": "completed",
"response": {
"company_name": "Northstar AS"
}
}Human in the loop is not one generic pause. The agent should create the smallest interaction that resolves the current uncertainty, persist its request id, and resume only from the recorded result.
Ask for facts or documents that are unavailable to the agent, then return typed fields and authenticated attachments.
Pre-fill generated or extracted values so a person can confirm correct fields and change only what is wrong.
Bind approve or reject to the exact action, object, and revision so a later decision cannot authorize changed work.
Software uses the HTTP resources directly. Authorized AI agents can use the same API or intention-oriented Fangst MCP tools.
POST/v1/requestsCreate a hosted request and receive its URL.GET/v1/requests/:idRead request status and configuration.GET/v1/requests/:id/submissionsRead completed responses.MCPrequest_human_inputLet an authorized agent create the request.MCPget_human_inputLet the agent read the completed response.Responsive pages, clear sender context, validation, private or shared links, expiry, and submission limits.
Typed values, authenticated file downloads, correlation metadata, timestamps, and stable response ids.
Polling, signed webhooks, retries with backoff, delivery history, idempotency, and replay.
Start with $1 free. Add funds from $10. Links, polling, webhooks, and abandoned requests do not use the main billable unit.
Create the hosted interaction through Fangst and receive the structured result back.