> For the complete documentation index, see [llms.txt](https://docs.nected.ai/nected-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nected.ai/nected-docs/management-api/global-variable-api/delete-global-variable.md).

# 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

> 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\`

```json
{"openapi":"3.0.3","info":{"title":"Nected Global Variable API","version":"1.0"},"tags":[{"name":"GlobalVariable","description":"Create, read, update, and delete global variables."}],"servers":[{"url":"https://api.nected.ai","description":"Production"}],"security":[{"DevAuth":[]}],"components":{"securitySchemes":{"DevAuth":{"type":"apiKey","in":"header","name":"Nected-API-Key","description":"Your Nected API key. Obtain from workspace settings."}},"schemas":{"Response":{"type":"object","description":"Generic response wrapper (used for delete)","properties":{"data":{"nullable":true},"code":{"type":"string"},"message":{"type":"string"}}},"ErrorResponse":{"type":"object","description":"Error response wrapper","properties":{"code":{"type":"string"},"message":{"type":"string","description":"Human-readable error description"},"data":{"nullable":true}}}}},"paths":{"/dev/variable/{name}":{"delete":{"operationId":"deleteGlobalVariableByName","tags":["GlobalVariable"],"summary":"Delete global variable by name","description":"Permanently delete a global variable by its `name`.\n\n**`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.\n\n**This operation is irreversible.** Any rules or workflows referencing this variable will need to be updated after deletion.\n\n**Canonical response file:** `examples/delete_variable_200.json`","parameters":[{"name":"Nected-Branch","in":"header","required":false,"description":"Branch name (optional)","schema":{"type":"string"}},{"name":"checksum","in":"header","required":true,"description":"Current checksum of the variable — from Create or Get response","schema":{"type":"string"}},{"name":"name","in":"path","required":true,"description":"The variable name","schema":{"type":"string"}}],"responses":{"200":{"description":"OK — variable deleted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response"}}}},"400":{"description":"Bad Request — checksum mismatch","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

### 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.