capabilities.work

Roll Out a Configuration Fragment

A 4-step recipe with Viam. We can help you get access.

Recipe · 4 steps

Roll Out a Configuration Fragment

with Viam

Create a fragment, verify it, and restart a part to adopt the new config.

  1. Create a private configuration fragment in the organization.
  2. List fragments in the organization to resolve the new fragment id.
  3. Read the fragment back by id to confirm it was created.
  4. Mark the target machine part for restart so it adopts the new config.
What you'll need to have ready
  • apiKey: Viam API key value sent in the key header.
  • organizationId: The organization the fragment belongs to.
  • fragmentName: Name for the new fragment.
  • config: The machine configuration object captured by the fragment.
  • partId: The machine part id that should restart to adopt the fragment.
For your developer

Arazzo workflow viam:fragment-rollout, 4 operations: createFragment → listFragments → getFragment → markPartForRestart. Specs on APIs.io.