Editar un contacto

PATCH 
/contacts/:id

Un campo ausente queda igual; null lo borra. attributes es un parche sobre los valores guardados, y tagIds es el conjunto completo de etiquetas. El consentimiento no se edita aquí — usa opt-in y opt-out.

Con una API key restringida a algunos números, un contacto sin conversación en esos números responde 404, como uno que no existe.

Request

Responses

200

Registro encontrado.

401

Token ausente, mal formado, desconocido o revocado (authentication), o cuenta suspendida (tenant_inactive).

402

Sin derecho de uso (payment_required). El cuerpo trae el motivo en reason y la salida en action: qué hacer (kind) y la página del panel donde se hace (url).

404

El recurso no existe (not_found).

409

contact_exists (el teléfono o BSUID ya es de otro contacto, con contactId) o contact_limit_reached (el plan llegó a su techo de contactos, con limit y plan).

422

El payload no pasó la validación (invalid_request, detallado en issues) o fue rechazado por Meta (meta_error, con el cuerpo original en meta).

429

Límite de peticiones superado (rate_limit).

Response Headers

Retry-After

Segundos a esperar antes de reintentar.

X-RateLimit-Category

Categoría de límite aplicada — send, media o default.

X-RateLimit-Scope

Qué cubo describen las otras cabeceras — key (la API key), session (el panel) o account (el techo de la cuenta).

X-RateLimit-Limit

Techo de peticiones de la categoría en la ventana actual.

X-RateLimit-Remaining

Peticiones restantes en la ventana actual.