Entrar

Guardar metadatos del cliente

PUT https://{organization}.myguper.com/api/register/customer/{id}/metadata

Upsert parcial de los metadatos de una persona. El cuerpo es un objeto plano { metaKey: value } — cada clave se crea o actualiza. Envía valor null o cadena vacía para eliminar una clave. Las claves ausentes del cuerpo no se modifican.

Cada metaKey se convierte a slug [a-z0-9_] (máx. 64) y se rechaza (422) si colisiona con una columna fija de person (ej.: email, name, gender). Los valores se guardan como texto; un valor numérico también llena valueNumber y un valor YYYY-MM-DD también llena valueDate (best-effort, para segmentación futura). Las claves nuevas se registran automáticamente en el catálogo custom-field.

Devuelve el mapa de metadatos ya normalizado.

Try-it values populated from environment ACME (Demo)


Autenticación

Token

Send your user token in the x-guper-authorization header.

Encabezados

Name Type Description
x-guper-authorization * string User token issued by Guper.
Content-Type * string Always `application/json` for endpoints that accept a JSON body.

Parámetros de ruta

Name Type Description
id * integer Person id.

Cuerpo de la petición

Content-Type: application/json

{
    "shirt_size": "G",
    "kid_birthday": "2015-03-01",
    "old_key": null
}

Respuestas

{
    "shirt_size": "G",
    "kid_birthday": "2015-03-01"
}
Copied to clipboard