List form instances on a task
Returns every form instance on the task, including templateId, current values, and a fields array for each instance. Each field includes valueKey — use that string as the property name in the values object when calling PATCH /tasks/{identifier}/form-instances/{formInstanceId}. To choose which template to attach next, list templates with GET /workspace/form-templates (template id is the templateId for POST). For the full static schema of a template (before attach), use GET /workspace/form-templates/{id}.
GET
/tasks/{identifier}/form-instancesAuthorization
AuthorizationOAuth2 access token · headerrequiredScopes:
api:reador
AuthorizationBearer token (JWT) · headerrequiredPath parameters
identifierstringrequiredTask UUID or shortNumber
Responses
200
401Unauthorized - Invalid or missing authentication token
403Forbidden - Insufficient API scopes or permissions
Request
curl -X GET "https://leadtime.app/api/public/tasks/string/form-instances" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"const response = await fetch("https://leadtime.app/api/public/tasks/string/form-instances", {
method: "GET",
headers: {
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
}
});import requests
response = requests.get(
"https://leadtime.app/api/public/tasks/string/form-instances",
headers={
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
},
)Response
No example response.
Unauthorized - Invalid or missing authentication token
Forbidden - Insufficient API scopes or permissions