Skip to main content
GET
/
api
/
v2
/
public
/
human-tasks
/
:id
curl -X GET "https://app.refold.ai/api/v2/public/human-tasks/{id}"

{
  "_id": "6a31a2f0d396207fd2510000",
  "name": "Approve Discount",
  "description": "Review and approve the requested discount.",
  "form_structure": {
    "type": "object",
    "required": ["approved"],
    "properties": {
      "approved": { "type": "boolean", "title": "Approve?" },
      "notes": { "type": "string", "title": "Notes" }
    }
  },
  "ui_structure": { "approved": { "ui:widget": "radio" } },
  "data": {},
  "status": "WAITING",
  "expire_in": "2026-06-20T00:00:00.000Z",
  "receiver_emails": ["approver@example.com"],
  "createdAt": "2026-06-16T13:20:00.000Z",
  "updatedAt": "2026-06-16T13:20:00.000Z"
}
Fetch a human task (a form generated by a workflow’s human-in-the-loop step) for end-user display. This is a public, no-auth endpoint — share the URL directly with the person who needs to fill out the form. Internal fields (delayed_job_id, instance_id, node_id, org_id, associated_form_id) are stripped from the response.
No API key or session token is required. The task ID is the secret — treat the link as sensitive.

​
Path Parameters

​
id
string
required
The human task ID (issued when the workflow reaches the human-task step).

​
Response

​
_id
string
Task ID.
​
name
string
Task name.
​
description
string
Task description.
​
form_structure
object
JSON-schema describing the form fields.
​
ui_structure
object
UI hints for rendering the form.
​
data
object
Any pre-filled data.
​
status
string
WAITING, SUBMITTED, or TIMEOUT.
​
expire_in
string
ISO 8601 expiry timestamp.
​
receiver_emails
array
Emails the task was sent to.
{
  "_id": "6a31a2f0d396207fd2510000",
  "name": "Approve Discount",
  "description": "Review and approve the requested discount.",
  "form_structure": {
    "type": "object",
    "required": ["approved"],
    "properties": {
      "approved": { "type": "boolean", "title": "Approve?" },
      "notes": { "type": "string", "title": "Notes" }
    }
  },
  "ui_structure": { "approved": { "ui:widget": "radio" } },
  "data": {},
  "status": "WAITING",
  "expire_in": "2026-06-20T00:00:00.000Z",
  "receiver_emails": ["approver@example.com"],
  "createdAt": "2026-06-16T13:20:00.000Z",
  "updatedAt": "2026-06-16T13:20:00.000Z"
}

curl -X GET "https://app.refold.ai/api/v2/public/human-tasks/{id}"