Farmbot-Web-App/batch_updates.md

Support Table

Not all resources support the experimental resource API.

Resource	Delete	Update / Insert
FarmEvent	❤️	💔
FarmwareInstallation	❤️	💔
Image	❤️	💔
Log	❤️	💔
Peripheral	❤️	💔
PinBinding	❤️	💔
PlantTemplate	❤️	💔
Point	❤️	💔
Regimen	❤️	💔
SavedGarden	❤️	💔
Sensor	❤️	💔
SensorReading	❤️	💔
Sequence	❤️	💔
Tool	❤️	💔
WebcamFeed	❤️	💔

Step 1: Send the Update

Send an MQTT message in the format of:

bot/device_<id>/resources_v0/<action>/<resource type>/<Transaction UUID>/<resource_id or 0>

Example 1-1:

bot/device_3/resources_v0/destroy/Sequence/2/123-456

NOTES:

• <Transaction UUID> can be any user defined string. Ensure that the string is unique. We recommend using UUIDs.
• <resource_id> This is the .id property of the resource you are deleting.
• <action> Only destroy is supported as of July 2018.
• <resource type> See "resource" column of table above. Case sensitive.

For deletion messages the body of the message is unimportant and is discarded by the server.

Step 2(A): Handle Failure

If your message is malformed or the server was unable to complete the request, you will receive an error message on the following MQTT channel:

bot/device_<id>/from_api

The message will take the same format as RPC errors:

{
  "kind": "rpc_error",
  "args": { "label": "THE UUID YOU GAVE THE SERVER" },
  "body": [
    {
      "kind": "explanation",
      "args": { "message": "Human readable explanation message" }
    }
  ]
}

Step 2(B): Handle Success

If successful, an rpc_ok CeleryScript node will be streamed to the following MQTT channel:

bot/device_<id>/from_api

This is not a JSON resource. It is merely an indication that the server has accepted the request and processed it. The resource itself will be streamed over the auto_sync* channel.