updateFormsDataByid

Atualize dados de formulário pelo ID. 🔐 Este método requer autorização.

Descrição

Atualiza um registro de dados de formulário enviado e resolve para o registro atualizado como um IUpdateFormsData.

Passe os novos campos como body.formData, com chaves por código de idioma: { formData: { en_US: [...] } }. Diferentemente de postFormsData(), este método não agrupa formData por idioma para você; um array plano é armazenado como está, e o registro deixa de aparecer em getFormsDataByMarker() para esse idioma. Sem formData, a API retorna 400 ("Provide a valid formData").

Apenas formData é lido do corpo; os demais campos são ignorados. A data e hora do registro e, para formulários que não são de avaliação, seu autor são definidos a partir de quem faz a chamada. Apenas o usuário que enviou o registro pode atualizá-lo; qualquer outra pessoa recebe 403.

.updateFormsDataByid(

,

);

Esquema de parâmetros

Esquema

id(required): number
ID dos dados do formulário.
exemplo: 1

body: object
Campos a atualizar: formData, indexado pelo código do idioma. Sem formData, a API retorna 400.

Exemplos

Exemplo mínimo

// 1. auth
const authData = [
  {
    marker: 'email',
    value: 'john@example.com',
  },
  {
    marker: 'password',
    value: '123456',
  },
];
await AuthProvider.auth('email', {
  authData,
});
// 2. update your form data record by id
const result = await FormData.updateFormsDataByid(
  1621, // FormData ID.
  {
    formData: {
      en_US: [
        {
          marker: 'name',
          type: 'string',
          value: 'John Smith',
        },
      ],
    },
  },
);

Exemplo de resposta

{
  "id": 1621,
  "formIdentifier": "test-form",
  "time": "2026-10-28T07:18:30.456Z",
  "formData": {
    "en_US": [
      {
        "marker": "name",
        "type": "string",
        "value": "John Smith"
      }
    ]
  },
  "userIdentifier": "john@example.com",
  "entityIdentifier": "blog",
  "parentId": null,
  "fingerprint": null,
  "isUserAdmin": false,
  "formModuleId": 2
}

Esquema de resposta

Esquema: IUpdateFormsData

id: number
ID do registro de dados do formulário.
exemplo: 12345

formIdentifier: string
Marcador do formulário.
exemplo: "contact_form"

time: string
Data e hora do envio.
exemplo: "2023-10-01T12:00:00Z"

formData: FormDataType[]
Campos do formulário agrupados por código de idioma, por exemplo { en_US: [...] }.

userIdentifier: string
Identificador (login) do usuário que enviou o formulário.
example: "john@example.com"

entityIdentifier: string
Identificador da entidade.
exemplo: "blog"

parentId: null | number
ID do registro pai.
exemplo: null

fingerprint: null | string
Impressão digital (fingerprint) do dispositivo do remetente.
exemplo: null

isUserAdmin: boolean
Se o registro foi enviado por um administrador.
exemplo: false

formModuleId: number
ID do módulo de formulário.
exemplo: 2

---