TRMNL Octri Demo
POST/api/plugin_installations/{plugin_installation_id}/configuration/evaluation

Evaluate pending installation configuration

Evaluates proposed changes to a plugin installation's pending configuration without saving them. Supply the current revision and a draft of up to 200 change operations to assess the configuration before updating it.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 parameter · 2 body fields
plugin_installation_idstringrequired
The UUID of the installation whose pending configuration to evaluate.

Draft configuration changes to evaluate without saving. Include both revision and draft.

draftarray<object>required
An array of up to 200 change operations. Each item requires `op` and `path`; `op` must be `set`, `unset`, or `clear_secret`, and `path` must begin with `/values/`. Include `value` for the value to set.
revisionstringrequired
The revision of the pending configuration that the draft applies to.

1 status code
200Returns the evaluated configuration, including its revision, values, secrets, sections, connections, actions, readiness, and synchronization data.
dataobjectoptional

Error handling

The plugin_installation_id path parameter must be a UUID identifying the installation to evaluate. The body requires revision and draft; draft can contain at most 200 items, each with op set to set, unset, or clear_secret and a path beginning with /values/.