> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bukiopay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Atualizar Campo Personalizado

> Muda o nome, o tipo, a obrigatoriedade ou os produtos de um campo do checkout. Envie só o que quer mudar.

Atualiza um campo do checkout. Envie apenas o que quer mudar; o resto continua como está.

**Método:** `PUT /api/v1/stores/me/custom-fields/:id`

**Autenticação:** Obrigatória. Inclua o header `Authorization: Bearer sk_live_sua_api_key`. A chave precisa ter a permissão **Tudo** (`*`).

## Parâmetros de caminho

<ParamField path="id" type="string" required>
  UUID do campo.
</ParamField>

## Parâmetros do corpo

Os mesmos de [Criar Campo](/api-reference/custom-fields/create), todos opcionais: `label`, `type`, `required`, `products`, `categories`, `allProducts`, `placeholder`, `min`, `max` e `position`.

<Warning>
  `products` e `categories` substituem a lista inteira. Para incluir um produto, envie a lista com os que já estavam e o novo.
</Warning>

## Exemplo de requisição

Vincular o Player ID a mais um produto:

```bash theme={null}
curl -X PUT 'https://api.bukiopay.com/api/v1/stores/me/custom-fields/6f1d2c3b-4a5e-4f60-8a7b-9c0d1e2f3a4b' \
  --header 'Authorization: Bearer sk_live_sua_api_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "products": [
      "c3b4168f-d732-44ed-8c67-6080cec06b09",
      "9d40e409-28e6-481f-aafc-83f97b831f07"
    ]
  }'
```

## Resposta

```json theme={null}
{
  "customField": {
    "id": "6f1d2c3b-4a5e-4f60-8a7b-9c0d1e2f3a4b",
    "label": "Player ID",
    "type": "NUMBER",
    "required": true,
    "products": [
      "c3b4168f-d732-44ed-8c67-6080cec06b09",
      "9d40e409-28e6-481f-aafc-83f97b831f07"
    ]
  }
}
```

A resposta traz o campo completo, com os mesmos dados de [Listar Campos](/api-reference/custom-fields/list).

## Erros comuns

| Status | Mensagem | Causa |
| - | - | - |
| `400` | Nada para atualizar. | Corpo vazio. |
| `400` | ID do campo inválido. | O `id` não é um UUID. |
| `404` | Campo não encontrado | O campo não existe ou é de outra loja. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.