PUpurplegrain
Tasks

Get the paddock a move left

Changed on

The related resource URL of a task's from_paddock relationship (JSON:API 1.1, "Related Resource Links"; decision 2026-10-28, G17): on a move, the paddock the mob left, as getPaddock returns it; data: null with a 200 on any row that is not a move, and on a move when the mob had never been placed. It is the relationship's links.related on getTask, built from the task's id alone, so it never changes. A task is readable by anyone, a paddock is not: the paddock is read under its own rights (any accepted member of the owning business, or the owner of a personal property), so a stranger gets a 404 and a signed-in caller without access a 403, as on getPaddock. Not an assistant's tool: an assistant reads the paddock with getPaddock and is refused here (403).

get/tasks/{id}/from_paddock

Request

  • Base URL
    https://api.purplegrain.com/api/v1
  • URL
    https://api.purplegrain.com/api/v1/tasks/{id}/from_paddock
  • Auth
    • none
    • or HTTP bearer

Path parameters

idstring required

Id of the task

Response

The paddock, or data: null when the task is not a move or the mob had never been placed

Example response

{
  "data": {
    "type": "paddock"
  }
}

Changes