Updating task form values

API call for updating task form values.

Task form values can only be submitted using the web API if there was a previous submission using the Mobile Tracker App (Android / iOS). The purpose of this feature is to correct any incorrectly filled data that was accidentally submitted. It is not intended for filling out an empty form from scratch.

This action can be used when the task status is unassigned, assigned, or arrived, and the device must not be deleted. Sub-users with the completed_form_update right can also update values when the task status is done, failed, or delayed.

API actions

API path: /task/form/values.

update

Updates existing form values of given task.

required sub-user rights: task_update.

Parameters

name	description	type
task_id	An ID of the task.	int
values	Map of field_id-value object	JSON object

where values object is:

{
    "1223344": {
      "type": "text",
      "value": "text field value"
    }
}

For value object description, see Form fields and values.

Examples

cURL

curl -X POST 'https://api.eu.navixy.com/v2/task/form/values/update' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "3b47a8672465f8009969caee36fda834", "task_id": 9677618, "values": {"2533373665146": {"type": "text", "value": "Hideo Kojima"}}}'

Response

{
    "success": true
}

Errors

• 101 – In demo mode this function disabled - if current user has "demo" flag.

• 201 – Not found in the database - if task with the specified ID does not exist.

• 255 – Invalid task state - if current task state is not unassigned, assigned or arrived (plus done, failed, and delayed for users with completed_form_update right).

• 242 – There were errors during content validation - if given values are invalid for the form. Example:

{
    "success": false,
    "status": {
        "code": 242,
        "description": "There were errors during content validation"
    },
    "errors": [
        {
            "field_id": "111-aaa-whatever",
            "code": 5,
            "error": "text length constraints are not met"
        }
    ]
}

Validation error codes:

• 1 – field required but has no value.

• 2 – field value type doesn't match field type.

• 3 – field value is null.

• 4 – value index out of bounds.

• 5 – invalid value size.

• 6 – value less than minimum.

• 7 – value more than maximum.

• 8 – field contains invalid references.

• 9 – invalid file type.

• 10 – invalid file state.