BRbrumby
device administration

Unassign Device From Farm

post/api/v1/admin/devices/{device_id}/assignments/unassign

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/admin/devices/{device_id}/assignments/unassign
  • Auth
    HTTP bearer

Path parameters

device_idstring required

Request body

reasonstring required

Response

Successful Response

installation_idstring uuid required
device_idstring required
external_farm_idstring required
farm_namestring required
assigned_by_actorstring required
assignment_reasonstring nullable required
kind'field' | 'bench' required

Why a device is at a farm.

FIELD is the record that matters: a dock physically installed somewhere, and the trail of where it has been. BENCH is a simulator pointed at a farm's geometry so it can fly it, which happens several times a day and means nothing about where any hardware is. Keeping them apart is what lets a bench move be cheap -- no reason typed, no weight -- without burying a real installation under forty test ones.

installed_atstring date-time required
uninstalled_atstring date-time nullable required
unassigned_by_actorstring nullable required
unassignment_reasonstring nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.