Atualizando um document específico

PUT https://api.fbits.net/document/values/{id}

Para atualizar um document, utilize o endpoint Atualiza um document.

Apenas o conteúdo do document é atualizado. A entidade do document é definida na criação e não pode ser alterada, por isso não é enviada no corpo.

Parâmetros para atualização:

- id - identificador do document;
- value - o document em JSON atualizado, validado contra o schema da entidade. Pode conter propriedades não declaradas no schema quando a entidade estiver com allowAdditionalProperties: true.

Request body:

{
  "value": "{\"sku\":\"ABC-123\",\"peso\":2.1}"
}

Response body:

{
  "id": 4501,
  "documentEntityId": 12,
  "value": "{\"sku\":\"ABC-123\",\"peso\":2.1}",
  "createdAt": "2026-07-27T16:20:00.000Z",
  "updatedAt": "2026-07-27T17:05:44.000Z"
}

🚧
O retorno é 400 quando o value não é um objeto JSON válido ou não satisfaz o schema da entidade, e 404 quando o document não existe na loja. Se a entidade estiver com allowAdditionalProperties: false, propriedades não declaradas no schema também resultam em 400, com o caminho da propriedade rejeitada (ex.: /cfg/extra).

📘
Alterar allowAdditionalProperties na entidade não revalida os documents já gravados: a nova regra vale a partir das próximas criações e atualizações. Um document que já possui propriedades adicionais passa a ser rejeitado na próxima atualização caso a entidade tenha voltado para false.

Updated 10 days ago