Routes
Tasks
Instructions

Update Task Instruction

Changed on

This request updates a Task Instruction.

All request body properties are optional. Include only the fields you want to update.

ParameterTypeRequiredDescription
instructionStringOptionalThe text that guides a User on what to do on this Instruction.
parentInstructionIDInt or nullOptionalThe instructionID of this Instruction's parent. A value of 0 or null removes the parent, making this a top-level Instruction.
responseDepends on the Instruction typeOptionalThe value the User submitted for this Instruction. This is not an object. See the request body schema and examples for the accepted value per Instruction type.

The response field is type-dependent. It is not an object. Example successful bodies: { "response": true } (checkbox), { "response": 12345 } (radio/dropdown itemOptionID), { "response": "Oil level at 75%" } (text), { "response": 1719878400 } (date), { "response": 42.5 } (number). See the request body schema and examples for accepted values per instruction type.

patch/v2/tasks/instructions/{instructionID}

Request

Request body

instructionstring

The text that guides a user on what to do on this instruction.

parentInstructionIDinteger nullable

The instructionID of this instruction's parent. A value of 0 or null removes the parent (makes this a top-level instruction).

Response

The operation completed successfully. The response body is empty.

Changes