Addresses1

ApiCredentials6

Asset resources1

Attachments2

Blocks4

BoundaryDrafts8

Categories2

Cities3

Clients6

Compliance exports6

Connection2

Contractors1

Documentation3

Drench records3

Fertiliser records3

Field work records3

Husbandry records3

Image uploads2

LikedContractors3

Locations1

Mobs8

OAuth11

OauthTokens4

Organization Join Links4

Organization Roles8

Organizations6

Paddocks8

Predictions1

Products1

Properties16

PropertySetupDrafts4

Public26

Services8

Sitemap5

Sowing records3

Spray records3

Subscriptions5

Tasks16

Treatment records3

Treatment register1

Users10

Blocks

Rename a block or change its paddocks

Changed on Oct 30, 2026

Renames a block, changes its kind or number, or (with paddock_ids) replaces its members: the listed live paddocks of the property move into it (out of any other block), and a member left out goes back to the home block (block_id null). Omitting paddock_ids leaves the members alone. Writes, moves or removes no record. To move one paddock, updatePaddock with block_id also works. Requires edit rights on the property.

patch/properties/{property_id}/blocks/{id}

Request

Base URL
https://api.purplegrain.com/api/v1
URL
https://api.purplegrain.com/api/v1/properties/{property_id}/blocks/{id}
Auth
HTTP bearer

Path parameters

property_idstring uuid required

The property's id.

idstring uuid required

The block's id.

Request body

Response

The updated block.

Example response

{
  "data": {
    "type": "block"
  }
}

Changes

Oct 30, 2026143d65e52617 Revision changes
- info
  added the non-success response with the status
- info
  added the non-success response with the status
Oct 30, 202692c4663a1266 Revision changes
- warning
  removed the optional property from the response with the status (media type: application/json)
- warning
  removed the optional property from the response with the status (media type: application/vnd.api+json)
- warning
  removed the optional property from the response with the status (media type: application/json)
- warning
  removed the optional property from the response with the status (media type: application/vnd.api+json)
- warning
  removed the optional property from the response with the status (media type: application/json)
- warning
  removed the optional property from the response with the status (media type: application/vnd.api+json)
- warning
  removed the optional property from the response with the status (media type: application/json)
- warning
  removed the optional property from the response with the status (media type: application/vnd.api+json)
- warning
  removed the optional property // from the response with the status (media type: application/json)
- warning
  removed the optional property // from the response with the status (media type: application/vnd.api+json)
- warning
  removed the optional property // from the response with the status (media type: application/json)
- warning
  removed the optional property // from the response with the status (media type: application/vnd.api+json)
- warning
  removed the optional property // from the response with the status (media type: application/json)
- warning
  removed the optional property // from the response with the status (media type: application/vnd.api+json)
- warning
  removed the optional property // from the response with the status (media type: application/json)
- warning
  removed the optional property // from the response with the status (media type: application/vnd.api+json)
- warning
  removed the optional property from the response with the status (media type: application/json)
- warning
  removed the optional property from the response with the status (media type: application/vnd.api+json)
- warning
  removed the optional property from the response with the status (media type: application/json)
- warning
  removed the optional property from the response with the status (media type: application/vnd.api+json)
- warning
  removed the optional property from the response with the status (media type: application/json)
- warning
  removed the optional property from the response with the status (media type: application/vnd.api+json)
- warning
  removed the optional property from the response with the status (media type: application/json)
- warning
  removed the optional property from the response with the status (media type: application/vnd.api+json)
- info
  added the optional property // to the response with the status (media type: application/json)
- info
  added the optional property // to the response with the status (media type: application/vnd.api+json)
- info
  added the optional property // to the response with the status (media type: application/json)
- info
  added the optional property // to the response with the status (media type: application/vnd.api+json)
- info
  added the optional property // to the response with the status (media type: application/json)
- info
  added the optional property // to the response with the status (media type: application/vnd.api+json)
- info
  added the optional property // to the response with the status (media type: application/json)
- info
  added the optional property // to the response with the status (media type: application/vnd.api+json)
- info
  added the optional property /// to the response with the status (media type: application/json)
- info
  added the optional property /// to the response with the status (media type: application/vnd.api+json)
- info
  added the optional property /// to the response with the status (media type: application/json)
- info
  added the optional property /// to the response with the status (media type: application/vnd.api+json)
- info
  added the optional property /// to the response with the status (media type: application/json)
- info
  added the optional property /// to the response with the status (media type: application/vnd.api+json)
- info
  added the optional property /// to the response with the status (media type: application/json)
- info
  added the optional property /// to the response with the status (media type: application/vnd.api+json)
- info
  added the optional property /// to the response with the status (media type: application/json)
- info
  added the optional property /// to the response with the status (media type: application/vnd.api+json)
- info
  added the optional property /// to the response with the status (media type: application/json)
- info
  added the optional property /// to the response with the status (media type: application/vnd.api+json)
- info
  added the optional property /// to the response with the status (media type: application/json)
- info
  added the optional property /// to the response with the status (media type: application/vnd.api+json)
- info
  added the optional property /// to the response with the status (media type: application/json)
- info
  added the optional property /// to the response with the status (media type: application/vnd.api+json)

Operation history (3 revisions)