> ## Documentation Index > Fetch the complete documentation index at: https://docs.plazbot.com/llms.txt > Use this file to discover all available pages before exploring further. # Update Contacts > Servicio para actualizar los campos de un contacto existente. Los campos que se pueden actualizar incluyen: name, lastname, email, stageId, segmentationId, entre otros. ## OpenAPI ````yaml PUT /api/contact openapi: 3.1.0 info: title: Plazbot description: >- Documentacion completa de la API de Plazbot. Incluye todos los servicios para gestion de contactos, conversaciones, mensajes, oportunidades, tareas, plantillas, agentes de IA, usuarios y workspaces. license: name: MIT version: 1.0.0 servers: - url: https://api.plazbot.com description: Servidor de produccion de Plazbot security: - bearerAuth: [] tags: - name: automation description: Servicios de automatizacion y nodos de IA - name: agent description: Servicios para gestion de Agentes de Inteligencia Artificial - name: contact description: Servicios para gestion de contactos del workspace - name: conversation description: Servicios para gestion de conversaciones y campanas - name: message description: Servicios para envio y gestion de mensajes - name: opportunity description: Servicios para gestion de oportunidades de negocio - name: task description: Servicios para gestion de tareas - name: template description: Servicios para gestion de plantillas de WhatsApp - name: user description: Servicios para gestion de usuarios y autenticacion - name: workspace description: Servicios para gestion de workspaces paths: /api/contact: put: tags: - contact summary: Actualizar Contacto description: >- Servicio para actualizar los campos de un contacto existente. Los campos que se pueden actualizar incluyen: name, lastname, email, stageId, segmentationId, entre otros. operationId: updateContact parameters: - name: id in: query description: ID del contacto a actualizar required: true schema: type: string - name: workspaceId in: query description: Identificador del workspace required: true schema: type: string - name: x-workspace-id in: header description: Identificador del workspace required: true schema: type: string requestBody: required: true content: application/json: schema: type: object properties: name: type: string description: Nombre del contacto lastname: type: string description: Apellido del contacto email: type: - string - 'null' description: Correo electronico stageId: type: - string - 'null' description: ID de la etapa del contacto segmentationId: type: - string - 'null' description: ID de segmentacion tags: type: array items: type: string description: IDs de etiquetas customFields: type: array items: $ref: '#/components/schemas/CustomField' description: Campos personalizados responses: '200': description: Contacto actualizado exitosamente content: application/json: schema: type: object properties: success: type: boolean description: Indica si la operacion fue exitosa code: type: integer description: Codigo HTTP de la respuesta errorCode: type: - string - 'null' description: Codigo de error, null si no hay error message: type: string description: Mensaje descriptivo del resultado data: type: object properties: id: type: string description: ID del contacto contact: $ref: '#/components/schemas/Contact' required: - success - code - errorCode - message - data '400': description: Solicitud incorrecta - Datos invalidos o faltantes content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: No autorizado - Token Bearer requerido o invalido content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Recurso no encontrado content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': description: Error interno del servidor content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - bearerAuth: [] components: schemas: CustomField: type: object description: Campo personalizado definido por el usuario properties: code: type: string description: Codigo del campo personalizado (Variable) value: type: string description: Valor de la variable personalizada Contact: type: object description: Informacion completa de un contacto en el workspace properties: id: type: string description: Identificador unico del contacto creationDate: type: string format: date-time description: Fecha de creacion del contacto assignedAgentId: type: - string - 'null' description: ID del agente asignado al contacto assignedAgentName: type: - string - 'null' description: Nombre del agente asignado segmentationId: type: - string - 'null' description: ID de segmentacion del contacto lastMessage: type: - string - 'null' description: Ultimo mensaje del contacto lastMessageDate: type: - string - 'null' format: date-time description: Fecha del ultimo mensaje platformSenderId: type: - string - 'null' description: ID del remitente en la plataforma platformSenderName: type: - string - 'null' description: Nombre del remitente en la plataforma platformSenderPhone: type: - string - 'null' description: Telefono del remitente en la plataforma platformSenderEmail: type: - string - 'null' description: Email del remitente en la plataforma isRead: type: boolean description: Indica si el contacto ha sido leido isBotEnabled: type: boolean description: Indica si el bot esta habilitado para este contacto isManuallyAdded: type: boolean description: Indica si el contacto fue agregado manualmente avatarColor: type: - string - 'null' description: Color del avatar del contacto orderInCards: type: integer description: Orden del contacto en la vista de tarjetas orderInCardsLastUpdated: type: - string - 'null' format: date-time description: Fecha de ultima actualizacion del orden tags: type: array items: $ref: '#/components/schemas/Tag' description: Etiquetas asignadas al contacto customFields: type: array items: $ref: '#/components/schemas/CustomField' description: Campos personalizados del contacto files: type: array items: type: string description: Archivos adjuntos del contacto isSolved: type: boolean description: Indica si la conversacion esta resuelta workspaceId: type: string description: ID del workspace al que pertenece name: type: string description: Nombre del contacto lastname: type: string description: Apellido del contacto email: type: - string - 'null' description: Correo electronico del contacto platformId: type: integer description: >- ID de la plataforma (1=Webchat, 2=Whatsapp, 3=Messenger, 4=Instagram, 5=Telegram, 6=Portal, 7=Code) stageId: type: - string - 'null' description: ID de la etapa del contacto internalWhatsappNumber: type: - string - 'null' description: Numero interno de WhatsApp del contacto blocked: type: boolean description: Indica si el contacto esta bloqueado ErrorResponse: type: object description: Respuesta de error estandar de la API properties: success: type: boolean description: Siempre false en errores code: type: integer description: Codigo HTTP del error errorCode: type: - string - 'null' description: Codigo de error especifico message: type: string description: Mensaje descriptivo del error required: - success - code - message Tag: type: object description: Etiqueta asignada a un contacto u oportunidad properties: id: type: string description: Identificador unico de la etiqueta name: type: string description: Nombre de la etiqueta color: type: - string - 'null' description: Color de la etiqueta en formato hexadecimal assignmentDate: type: - string - 'null' description: Fecha de asignacion de la etiqueta format: date-time securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- Token de autenticacion Bearer. Obtenga el token usando el endpoint /api/user/login ````