---
title: "Update Variable"
method: PATCH
path: "/app/variable/{variable-id}"
tags: ["Variables"]
---

# Update Variable

`PATCH /app/variable/{variable-id}`

Atualiza uma variável existente.

## Path parameters

- `variable-id` number, required

## Request body

- object
  - `name` string — Identificador único da variável. Apenas letras, números, `-` e `_`
  - `description` string — Descrição exibida para o cliente
  - `type` 'SELECT' | 'NUMBER' | 'TEXT' | 'ROBLOX', required — Tipo da variável: `SELECT`, `NUMBER`, `TEXT` ou `ROBLOX`
  - `required` boolean — Se o preenchimento é obrigatório
  - `regex` string — Expressão regular para validação
  - `applies_to` number[] — IDs dos pacotes aos quais a variável de checkout se aplica
  - `options` object[] — Opções disponíveis (obrigatório quando o tipo é `SELECT`, mínimo 2). Opções existentes são atualizadas por nome, novas opções são criadas, e opções removidas são desativadas
    - `name` string, required — Nome da opção
    - `value` string, required — Valor da opção
    - `price` number — Preço adicional da opção (entre 1 e 1.000.000)

## Response `200`

Variável atualizada

- Variable
  - `id` number — ID único da variável
  - `store_id` number — ID da loja
  - `name` string — Identificador da variável (usado em comandos como `{nome_variavel}`)
  - `description` string — Descrição da variável exibida para o cliente
  - `type` 'SELECT' | 'NUMBER' | 'TEXT' | 'ROBLOX' — Tipo da variável (`SELECT`, `NUMBER`, `TEXT`, `ROBLOX`)
  - `required` boolean — Se o preenchimento é obrigatório
  - `regex` string, nullable — Expressão regular para validação do campo
  - `applies_to` number[], nullable — IDs dos pacotes aos quais a variável de checkout se aplica
  - `bracket_display` string — Nome formatado para uso em comandos (ex: `{nickname}`)
  - `display` string — Nome formatado para exibição
  - `options` VariableOption[] — Opções disponíveis (quando o tipo é `SELECT`)
    - `id` number — ID da opção
    - `name` string — Nome da opção
    - `value` string — Valor da opção
    - `price` number, nullable — Preço adicional da opção

---

[API](https://skmtc.net/centralcart/apis/centralcart-api.md) · [All operations](https://skmtc.net/centralcart/apis/centralcart-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/centralcart/centralcart-api/revisions/6cbd98848375/schema)