Skip to main content

Bulk update nodes via S3

POST 
/v1/admin/nodes/update-jobs

Initiates an asynchronous job to update already-registered nodes from a CSV file stored in S3. Use this for two related operations on existing nodes:

  • Metadata updates (admin groups, tags, plus any extra CSV columns treated as key:value tags via the registration convention).
  • Cert update: when a CSV row has a non-empty certs column the node's cloud-side cert is replaced (register new, attach, deactivate the old). This is operator correction for a mistakenly-registered PEM — it does not push the new cert to the device.

Symmetric with POST .../registration-jobs: returns 202 Accepted with a request_id, kicks off the shared Fargate task, status visible via GET .../update-jobs/{requestId} and GET .../update-jobs/{requestId}/failed-nodes.

Request​

Responses​

Bulk update job accepted