---
title: "Update Task Instruction"
method: PATCH
path: "/v2/tasks/instructions/{instructionID}"
tags: ["Routes", "Tasks", "Instructions"]
---

# Update Task Instruction

`PATCH /v2/tasks/instructions/{instructionID}`

This request updates a Task Instruction.

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

The `response` field is type-dependent — see the request body schema for accepted values per instruction type.

## Request body

- object
  - `instruction` string — The text that guides a user on what to do on this instruction.
  - `parentInstructionID` integer, nullable — The instructionID of this instruction's parent. A value of 0 or null removes the parent (makes this a top-level instruction).
  - `response` unknown

## Response `200`

The operation completed successfully. The response body is empty.

## Other responses

- `400` — The request was malformed — either invalid JSON syntax or a validation failure (missing required field, wrong type, etc.).
- `401` — No `Authorization` header was provided on the request.
- `403` — The supplied credentials are invalid, the customer account is inactive, or the credentials do not have permission to perform this action.
- `404` — The referenced resource does not exist or is not visible to the authenticated customer.
- `409` — The request conflicts with the current state of the resource (e.g. a uniqueness constraint or a referenced parent that is in the wrong state).
- `429` — The per-minute or per-hour rate limit for this credential and method has been exhausted. Inspect the `X-RateLimit-*` headers to determine when to retry.
- `500` — An unhandled server-side error. The body message is generic (`System unavailable...`) when the underlying cause is a database fault; otherwise it reflects the raised error.

---

[API](https://skmtc.net/limblecmms/apis/limble-api-v2.md) · [All operations](https://skmtc.net/limblecmms/apis/limble-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/limblecmms/limble-api-v2/revisions/eceb9442ed4d/schema)