NetSapiens icon

NetSapiens

Interact with the NetSapiens API

Actions477

Configs/Configuration Definitions → Update a Configuration Definition

AI-generated

Summary

Update a configuration definition by providing its name and body, optionally refreshing cached dropdown options.

Inputs

  • refreshOptions — Whether to bypass cached dropdown values and fetch fresh options
  • PutConfigDefinitionsBy__path__config-name (required) —
  • PutConfigDefinitionsBy__body —

Output shape

the updated configuration definition object

Success response typically returns the modified definition; failures return an error envelope.

Examples

Example 1: Update SMTP host configuration without refreshing dropdowns

refreshOptions: false, PutConfigDefinitionsBy__path__config-name: "smtp_host", PutConfigDefinitionsBy__body: {"host": "mail.example.com"}

Example 2: Force fresh options while updating a domain configuration

refreshOptions: true, PutConfigDefinitionsBy__path__config-name: "domains", PutConfigDefinitionsBy__body: {"newDomain": "test.example.com"}

Links

Discussion