Correlate every upload
Keep customer, case, or transaction identifiers in private metadata so filenames never become your database key.
Input, files, and approvals from people
Your software or AI agent specifies the files it needs. Fangst returns a hosted upload link. The person uploads the files, and your system receives the result.
Attach your own customer and case identifiers as private metadata, then receive the uploaded files against the right record.
POST https://api.fang.st/v1/requests
Authorization: Bearer <FANGST_API_TOKEN>
Content-Type: application/json
{
"title": "Customer documents",
"metadata": {
"customer_id": "cus_123"
},
"fields": [
{
"key": "contract",
"type": "file",
"required": true
},
{
"key": "supporting_files",
"type": "files"
}
]
}{
"status": "completed",
"attachments": [
{
"id": "file_01",
"name": "contract.pdf"
}
]
}A file request is more than an upload field. The request must identify the right case, limit what can be submitted, protect the uploaded files, and tell your software when the response is ready.
Keep customer, case, or transaction identifiers in private metadata so filenames never become your database key.
Define required files, accepted content types, file counts, byte limits, expiry, and submission limits before sharing the link.
Receive stable attachment ids in the response, then download the encrypted files through the authenticated API.
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.