Actualizar Operador

PATCH /api/operators/:id

Actualiza los campos de un operador.

Los metadatos se fusionan, no se reemplazan: las claves enviadas sobrescriben las del mismo nombre, las no enviadas se conservan, y enviar una clave con null la elimina. La fusión es recursiva (RFC 7386 JSON Merge Patch): los objetos anidados se fusionan nivel por nivel, así podés actualizar una clave dentro de un objeto anidado sin reenviar sus hermanas. Cualquier otro valor reemplaza al anterior por completo, incluidos los arrays, que nunca se fusionan elemento a elemento. Enviar metadata: null vacía la bolsa entera.

Auth: Requerida — permiso operator:manage

Parámetros de Ruta

Parámetro	Tipo	Descripción
`id`	UUID	ID del operador

Cuerpo de la Solicitud

Todos los campos son opcionales:

Campo	Tipo	Descripción
`name`	string	Nombre del operador
`email`	string	Dirección de correo electrónico
`phone`	string	Número de teléfono
`is_active`	boolean	Estado activo
`metadata`	object	JSON arbitrario, fusionado recursivamente; `null` lo vacía

Ejemplo

curl -X PATCH https://api.reten.ai/api/operators/cc0e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer <token>" \
  -H "x-tenant-id: <tenant-id>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "John Smith",
    "phone": "+56987654321",
    "metadata": { "region": "north" }
  }'

const operatorId = "cc0e8400-e29b-41d4-a716-446655440000";
const response = await fetch(`https://api.reten.ai/api/operators/${operatorId}`, {
  method: "PATCH",
  headers: {
    "Authorization": "Bearer <token>",
    "x-tenant-id": "<tenant-id>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    name: "John Smith",
    phone: "+56987654321",
    metadata: { region: "north" },
  }),
});
const operator = await response.json();

import requests

operator_id = "cc0e8400-e29b-41d4-a716-446655440000"
response = requests.patch(
    f"https://api.reten.ai/api/operators/{operator_id}",
    headers={
        "Authorization": "Bearer <token>",
        "x-tenant-id": "<tenant-id>",
    },
    json={
        "name": "John Smith",
        "phone": "+56987654321",
        "metadata": {"region": "north"},
    },
)
operator = response.json()

Respuesta `200 OK`

Devuelve el objeto del operador actualizado.