Get the pending Fill Form review task

GET

/spaces/:spaceId/runs/:runId/task

GET

/spaces/:spaceId/runs/:runId/task

$ curl https://api.cloudraker.com/spaces/spaceId/runs/runId/task \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json"

1 {
2   "runId": "a3f47b2e-9c4d-4f1a-8b2e-3d7f9a1c5e6b",
3   "docName": "Employee Onboarding Form",
4   "templateFileId": "tpl_20240615_001",
5   "outputMode": "flattened",
6   "fields": [
7     {
8       "name": "fullName",
9       "type": "text",
10       "label": "Full Name",
11       "required": true,
12       "page": 0,
13       "order": 1,
14       "section": "Personal Information",
15       "hint": "Enter your legal full name",
16       "options": [],
17       "maxLength": 100,
18       "multiline": false,
19       "box": {
20         "x": 72,
21         "y": 144,
22         "w": 300,
23         "h": 20
24       }
25     }
26   ],
27   "values": {
28     "fullName": "Jane Alexandra Doe"
29   },
30   "pageBoxes": [
31     {
32       "width": 612,
33       "height": 792
34     }
35   ],
36   "pageCount": 1
37 }

The in-app review payload for a paused fill-form run: the drafted field values, the curated field inventory, and the template’s page geometry (FillTask — { runId, docName, templateFileId, outputMode, fields, values, pageBoxes, pageCount }). Requires space:read (denied → 404). 404 once the task is consumed/expired or for a run of any other action. The render bytes come from getRunTaskPdf.

The in-app review payload for a paused `fill-form` run: the drafted field values, the curated field inventory, and the template's page geometry (`FillTask` — `{ runId, docName, templateFileId, outputMode, fields, values, pageBoxes, pageCount }`). Requires `space:read` (denied → 404). 404 once the task is consumed/expired or for a run of any other action. The render bytes come from `getRunTaskPdf`.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

spaceIdstringRequired

runIdstringRequired

Response

The pending review task.

runIdstring

docNamestring

templateFileIdstring or null

outputModeenum

fieldslist of objects

The curated, fillable field inventory.

valuesmap from strings to any

The drafted values, keyed by field name.

pageBoxeslist of objects

pageCountinteger-9007199254740991-9007199254740991

Errors

404

Not Found Error