variable-library-cli

Create a Variable Library by POSTing to /v1/workspaces/{ws}/items with type VariableLibrary and a definition containing base64-encoded parts: variables.json, settings.json, and optional valueSets/<name>.json files. Omit the format field entirely, and handle the 202 response with LRO polling.

Set the active value set with PATCH /v1/workspaces/{ws}/variableLibraries/{id} and a body of {"properties":{"activeValueSetName":"<name>"}}. This changes workspace item state only; it does not edit definition files or appear in a Git diff.

Add a libraryVariables block under pipeline properties with libraryName, libraryId, variableName, and type, then reference it with the expression object {"value": "@pipeline().libraryVariables.x", "type": "Expression"}. Map Boolean to Bool and Integer to Int; Number is not supported in pipelines per Microsoft Learn.

This error occurs when a value set variableOverrides[].value is a string for a Boolean, Integer, or Number variable. Use the variable's native JSON type (false, 1000000) instead of a string, even though the REST documentation lists the field as String.

The active value set is workspace item state, not part of the serialized definition, so it never appears in Git. Verify it with GET /variableLibraries/{id}, since the generic /items/{id} endpoint omits the properties block.

Read it with notebookutils.variableLibrary.getLibrary("name") or the $(/**/Library/Variable) path, then coerce defensively with str(value).lower() == "true". Never use bool(value), because the string "false" is truthy in Python.