---
title: "Patch Farm"
method: PATCH
path: "/api/v1/farms/{farm_id}"
tags: ["farms"]
---

# Patch Farm

`PATCH /api/v1/farms/{farm_id}`

## Request

- Base URL: `https://api.brumby.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.brumby.com/api/v1/farms/{farm_id}`
- Auth: HTTP bearer

## Path parameters

- `farm_id` string, required

## Request body

- FarmUpdate: Manual farms only: a synced farm's facts belong to the feed. Notes and archival are editable on either.
  - `name` string, nullable
  - `owner_name` string, nullable
  - `owner_email` string, nullable
  - `members` FarmMember[], nullable
    - `name` string, nullable
    - `email` string, nullable
    - `role` string
  - `boundary` object, nullable
  - `notes` string, nullable
  - `archived` boolean, nullable

## Response `200`

Successful Response

- FarmResponse
  - `farm_id` string, required
  - `name` string, required
  - `source` string, required
  - `owner_name` string, nullable, required
  - `owner_email` string, nullable, required
  - `members` unknown[], required
    - unknown
  - `boundary` object, nullable, required
  - `notes` string, nullable, required
  - `centre` number[], nullable, required
  - `paddock_count` integer, required
  - `base_station_count` integer, required
  - `devices` FarmDeviceSummary[], required
    - `device_id` string, required
    - `display_name` string, nullable, required
    - `hardware_kind` 'n100' | 'jetson', required
    - `lifecycle` 'inventory' | 'commissioned' | 'active' | 'maintenance' | 'retired', required
    - `availability` 'online' | 'offline', required
    - `installed_at` string, date-time, required
  - `synced_at` string, date-time, nullable, required
  - `created_by` string, required
  - `archived_at` string, date-time, nullable, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `sim_profile` FarmSimProfileSummary: Whether a farm is a simulated one, as the farm list carries it. The farm list is what the gate, the farm pages and the Testing page all poll already, so the flag rides on it rather than on a second list.
    - `world_slug` string, required
    - `flyable` boolean, required
    - `buildable` boolean, required
    - `default_paddock` string, nullable, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/brumby/apis/brumby-platform-api.md) - [All operations](https://skmtc.dev/brumby/apis/brumby-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/brumby/apis/brumby-platform-api/revisions/fe185e20813e?raw)