documentCreate

A mutation DocumentCreate permite criar um document em uma entidade, identificada pelo nome.

O document é validado contra o schema da entidade antes de ser gravado. A operação exige que a entidade declare CREATE em publicOperations.

Parâmetros

ArgumentoTipoObrigatórioDescrição
entityNameString!SimNome da entidade. Não diferencia maiúsculas de minúsculas
valueAnySimO document, como um objeto JSON

Campos de retorno

Os campos de retorno são os do document criado.

CampoTipoDescrição
idStringIdentificador do document criado, em hash
dataAnyO document gravado, com os campos públicos projetados

Exemplo

mutation {
  documentCreate(
    entityName: "ficha-tecnica"
    value: { sku: "ABC-123", cor: "Azul", custo: 42.5 }
  ) {
    id
    data
  }
}
Mostrar resposta
{
  "data": {
    "documentCreate": {
      "id": "eyJFbnRpdHkiOiJEb2N1bWVudFZhbHVlIiwiSWQiOjQ1MDF9",
      "data": {
        "sku": "ABC-123",
        "cor": "Azul"
      }
    }
  }
}

O document é gravado por completo, inclusive os campos não públicos, mas o retorno traz somente os campos com publicView: true — no exemplo, custo é gravado e omitido na resposta.