Skip to main content
POST
/
api
/
v2
/
public
/
human-tasks
/
:id
curl -X POST "https://app.refold.ai/api/v2/public/human-tasks/{id}" \
  -H "Content-Type: application/json" \
  -d '{
    "data": {
      "approved": true,
      "notes": "Looks good — approved."
    }
  }'

{
  "message": "Form submitted successfully"
}
Submit a response to a human task. This is a public, no-auth endpoint — the person who received the form posts their answers here. The submission is validated against the form’s JSON schema (required fields, read-only fields), and submitting resumes the paused workflow.
No API key or session token is required. Submitting an already-submitted, expired, or incomplete form returns a 400.

​
Path Parameters

​
id
string
required
The human task ID.

​
Body Parameters

​
data
object
required
The form answers, matching the task’s form_structure. Required fields must be present.

​
Response

The task is marked submitted and the workflow resumes. Returns a confirmation.
{
  "message": "Form submitted successfully"
}

curl -X POST "https://app.refold.ai/api/v2/public/human-tasks/{id}" \
  -H "Content-Type: application/json" \
  -d '{
    "data": {
      "approved": true,
      "notes": "Looks good — approved."
    }
  }'