PUpurplegrain
Drench records

Update Drench Record

Changed on

Deprecated alias for changing a drench's head and products. The app and an API key can still call it. An AI assistant cannot: the response is 403 with detail "An AI assistant cannot call this." An assistant uses updateTreatmentRecord.

products replaces the set. On a done record this never reopens the task; on an open task the same child is updated. Answers with the task exactly as GET /tasks/{id} would. id is the treatment id (drench.id on the task, the same value as treatment.id), not the task id. A done record with no product row is refused (422, "A drench needs at least one product"). Photos travel the same way as on a treatment update (image_upload_ids, image_urls, image_base64s, image_mode, remove_image_ids). If any image fails, the whole update is rolled back.

patch/drench-records/{id}

Request

  • Base URL
    https://api.purplegrain.com/api/v1
  • URL
    https://api.purplegrain.com/api/v1/drench-records/{id}
  • Auth
    HTTP bearer

Path parameters

idstring required

The DrenchRecord id (drench.id on the task).

Request body

Example request

{
  "data": {
    "date": "2025-12-23",
    "description": "Drench rams"
  }
}

Response

Success. The task, with its drench.

Example response

{
  "data": {
    "type": "task"
  }
}

Changes

  • 370fe2f3ed4fRevision changes
    • info

      added the new enum value to the request property //// (media type: application/vnd.api+json)

    • info

      added the new enum value to the request property //// (media type: application/vnd.api+json)

    • info

      added the new enum value to the request property /// (media type: application/json)

    • info

      added the new enum value to the request property /// (media type: application/json)

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

  • e32f34ba218bRevision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status