> ## Documentation Index
> Fetch the complete documentation index at: https://cobalt-55-abhishek.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Submit Human Task

> Submit a public human task (form) response.

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.

<Note>
  No API key or session token is required. Submitting an already-submitted, expired, or incomplete form returns a `400`.
</Note>

## Path Parameters

<ParamField path="id" type="string" required>The human task ID.</ParamField>

## Body Parameters

<ParamField body="data" type="object" required>
  The form answers, matching the task's `form_structure`. Required fields must be present.
</ParamField>

## Response

<Tabs>
  <Tab title="200 OK">
    The task is marked submitted and the workflow resumes. Returns a confirmation.
  </Tab>

  <Tab title="400 Bad Request">
    Returned when the form is already submitted, expired, or missing required fields.
    <ResponseField name="status_code" type="integer">HTTP status code.</ResponseField>
    <ResponseField name="http_error_type" type="string">Error category.</ResponseField>
    <ResponseField name="error_code" type="string">Internal error code.</ResponseField>
    <ResponseField name="message" type="string">Human-readable error description.</ResponseField>
  </Tab>

  <Tab title="404 Not Found">
    <ResponseField name="status_code" type="integer">HTTP status code.</ResponseField>
    <ResponseField name="message" type="string">`Specified Form Not Found`.</ResponseField>
  </Tab>
</Tabs>

<ResponseExample>
  ```json 200 theme={null}
  {
    "message": "Form submitted successfully"
  }
  ```

  ```json 400 theme={null}
  {
    "status_code": 400,
    "http_error_type": "BAD_REQUEST",
    "error_code": "SERVER_ERROR",
    "message": "Form has already been submitted"
  }
  ```

  ```json 404 theme={null}
  {
    "status_code": 404,
    "http_error_type": "NOT_FOUND",
    "error_code": "SERVER_ERROR",
    "message": "Specified Form Not Found"
  }
  ```
</ResponseExample>

<RequestExample>
  ```bash cURL theme={null}
  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."
      }
    }'
  ```
</RequestExample>