Delete Global Variable

Permanently delete a global variable by its name. This operation is irreversible — any rules or workflows referencing this variable will need to be updated after deletion.

Delete global variable by name

delete

Permanently delete a global variable by its name.

checksum header is required — must match the server's current checksum. Obtain it from GET /dev/variable/{name} → data.checksum. If it does not match, the delete is rejected.

This operation is irreversible. Any rules or workflows referencing this variable will need to be updated after deletion.

Canonical response file: examples/delete_variable_200.json

Authorizations

DevAuth

Nected-API-KeystringRequired

Your Nected API key. Obtain from workspace settings.

Path parameters

namestringRequired

The variable name

Example: tax_rate_gst

Header parameters

Nected-BranchstringOptional

Branch name (optional)

checksumstringRequired

Current checksum of the variable — from Create or Get response

Example: a3f1b2c4d5e6f7a8b9c0d1e2f3a4b5c6

Responses

200

OK — variable deleted

application/json

Generic response wrapper (used for delete)

dataany · nullableOptional

codestringOptional

messagestringOptional

400

Bad Request — checksum mismatch

application/json

500

Internal Server Error

application/json

delete

/dev/variable/{name}

HTTPcURLJavaScriptPython

DELETE /dev/variable/{name} HTTP/1.1
Host: api.nected.ai
Nected-API-Key: YOUR_API_KEY
checksum: a3f1b2c4d5e6f7a8b9c0d1e2f3a4b5c6
Accept: */*

{
  "data": null,
  "code": "success",
  "message": "Variable deleted successfully."
}

Checksum (required)

The checksum must be sent as a request header. Obtain the current checksum from Get global variable by name → data.checksum. If the checksum does not match the server's current state, the delete is rejected.

No request body is required.