Crear o actualizar agente
PUT/v1/agents
Upsert. Recibe el mismo cuerpo que POST más las claves de búsqueda id y external_id, comparadas en ese orden. Una coincidencia se actualiza in situ y devuelve 200 — los campos ausentes del cuerpo conservan el valor almacenado. Sin clave, o sin coincidencia, crea el agente exactamente como lo haría POST y devuelve 201.
Request
Responses
- 200
- 201
- 400
- 401
- 403
- 404
- 409
- 422
Éxito.
Éxito.
El cuerpo no superó la validación de Zod. error.details contiene formErrors/fieldErrors.
Fallo de autenticación (JWT o mTLS ausente o inválido).
Autenticado, pero el scope es insuficiente o el recurso está fuera de alcance.
Recurso no encontrado o excluido por soft-delete.
Se violó una restricción de unicidad (por ejemplo, external_id o el email del inbox ya en uso).
Validación del cuerpo que requiere contexto del lado del servidor (por ejemplo, dominio del inbox no coincide).