updateFormsDataByid

Actualiza datos de formulario por ID. 🔐 Este método requiere autorización.

Descripción

Actualiza un registro de datos de formulario enviado y se resuelve en el registro actualizado como IUpdateFormsData.

Pasa los nuevos campos como body.formData, indexados por código de idioma: { formData: { en_US: [...] } }. A diferencia de postFormsData(), este método no envuelve formData por idioma por ti; un array plano se almacena tal cual, y entonces el registro deja de aparecer en getFormsDataByMarker() para ese idioma. Sin formData, la API devuelve 400 ("Provide a valid formData").

Del cuerpo solo se toma formData; los demás campos se ignoran. La hora del registro y, en los formularios que no son de valoración, su autor se establecen a partir de quien llama. Solo el usuario que envió el registro puede actualizarlo; cualquier otro recibe 403.

.updateFormsDataByid(

,

);

Esquema de parámetros

Esquema

id(required): number
ID de los datos del formulario.
ejemplo: 1

body: object
Campos que se actualizan: formData, con el código de idioma como clave. Sin formData, la API devuelve 400.

Ejemplos

Ejemplo 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',
        },
      ],
    },
  },
);

Ejemplo de respuesta

{
  "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 respuesta

Esquema: IUpdateFormsData

id: number
ID del registro de datos del formulario.
ejemplo: 12345

formIdentifier: string
Marcador del formulario.
ejemplo: "contact_form"

time: string
Fecha y hora del envío.
ejemplo: "2023-10-01T12:00:00Z"

formData: FormDataType[]
Campos del formulario agrupados por código de idioma, por ejemplo { en_US: [...] }.

userIdentifier: string
Identificador (login) del usuario que envió el formulario.
example: "john@example.com"

entityIdentifier: string
Identificador de la entidad.
ejemplo: "blog"

parentId: null | number
ID del registro padre.
ejemplo: null

fingerprint: null | string
Huella digital del dispositivo del remitente.
ejemplo: null

isUserAdmin: boolean
Indica si el registro lo envió un administrador.
ejemplo: false

formModuleId: number
ID del módulo de formulario.
ejemplo: 2

---