---
title: "Set custom value for a variable on a server"
method: POST
path: "/api/clusters/{clusterName}/servers/{serverName}/variables-set-custom"
tags: ["DatabaseConfig"]
---

# Set custom value for a variable on a server

`POST /api/clusters/{clusterName}/servers/{serverName}/variables-set-custom`

## Request

- The document declares no server URL.
- Auth: none declared. Required headers: `Authorization`

Sets a custom preserved value for a variable on a specified server within a cluster. This allows DBAs to manually override variable values like in my.cnf.

## Path parameters

- `clusterName` string, required
- `serverName` string, required

## Query parameters

- `variableName` string, required
- `customValue` string, required

## Headers

- `Authorization` string, required

## Response `200`

Variable custom value set successfully

- string

## Other responses

- `400`: Variable name or custom value required
- `403`: No valid ACL
- `500`: Cluster Not Found" or "Server Not Found" or "Error setting custom variable value

## Changes

- **2026-07-17** `7465ea0ee21a`: 1 info
  - endpoint added
- **2023-03-31** `b57fc7b9446e`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/signal18/apis/signal-18-dashboard-api/changes/api/clusters/:clusterName/servers/:serverName/variables-set-custom/post.md)

---

[API](https://skmtc.dev/signal18/apis/signal-18-dashboard-api.md) - [All operations](https://skmtc.dev/signal18/apis/signal-18-dashboard-api/llms.txt) - [OpenAPI document](https://skmtc.dev/signal18/apis/signal-18-dashboard-api/revisions/8ee8a1e31294?raw)