> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ugps.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Elegir un avatar predefinido para un conductor

> Deja uno de los avatares predefinidos (inicial, silueta o ilustración de conductor, con su color) como avatar de la ficha. Si la ficha tenía una foto
subida, la foto se borra. Queda en el Registro de actividades como edición del conductor.

**Permisos requeridos:** `access_drivers`




## OpenAPI

````yaml /openapi.json put /api/drivers/{id}/avatar
openapi: 3.0.0
info:
  title: UGPS Atlas API
  version: 1.0.0
  description: >-
    Documentación de la API REST principal de UGPS Atlas (plataforma de rastreo
    GPS)
servers:
  - url: https://api.ugps.io
    description: Servidor de producción
security:
  - bearerAuth: []
  - cookieAuth: []
tags:
  - name: Auth - Autenticación
    description: Operaciones de autenticación
  - name: Usuarios - Usuarios
    description: Operaciones relacionadas con usuarios
  - name: Usuarios - Roles
    description: Operaciones relacionadas con roles
  - name: Usuarios - Permisos
    description: Operaciones relacionadas con permisos
  - name: Activos - Assets
    description: Operaciones relacionadas con activos
  - name: Activos - Tipos
    description: Operaciones relacionadas con tipos de activos
  - name: Activos - Grupos
    description: Operaciones relacionadas con grupos de activos
  - name: Activos - Campos personalizados
    description: >-
      Campos propios que cada empresa define para sus activos (nombre interno,
      tipo, reglas y opciones)
  - name: Activos - Grupos de campos
    description: Grupos que ordenan los campos personalizados de la empresa
  - name: Activos - Vehículos
    description: Operaciones relacionadas con tipos de vehículos
  - name: Activos - QR
    description: >-
      QR del activo (identidad escaneable del activo): resolver, stickers,
      reemplazo e historial
  - name: Tracking - Trackers
    description: Operaciones relacionadas con trackers
  - name: Tracking - Viajes
    description: Operaciones relacionadas con viajes y paradas
  - name: Tracking - Geocercas
    description: Operaciones relacionadas con geocercas
  - name: Alertas - Alertas
    description: Operaciones relacionadas con alertas
  - name: Alertas - Disparadores
    description: Operaciones relacionadas con disparadores de alertas
  - name: Alertas - Notificaciones
    description: Operaciones relacionadas con notificaciones
  - name: Clientes - Clientes
    description: Operaciones relacionadas con clientes
  - name: Clientes - Restricciones
    description: Operaciones relacionadas con restricciones
  - name: Integraciones - Flespi
    description: Operaciones relacionadas con Flespi
  - name: Otros - Conductores
    description: Operaciones relacionadas con conductores
  - name: Formularios dinámicos
    description: Plantillas de formulario propias de Atlas, asignables a activos
  - name: Inspecciones
    description: >-
      Inspecciones de activos enviadas desde la app al escanear el QR, con
      resultado apta / no apta
  - name: Otros - Capas
    description: Operaciones relacionadas con capas
  - name: User Tracker Access
    description: Operaciones de acceso personalizado a trackers por usuario
  - name: Reportes - Historial de Posiciones
    description: Estadísticas y detalle de posiciones GPS por activo
  - name: Reportes - Excesos de Velocidad
    description: Reportes de excesos de velocidad por tracker
  - name: Reportes - Ralentí
    description: Reportes de ralentí (motor encendido sin movimiento) por tracker
  - name: Reportes - Horas de Trabajo
    description: >-
      Reportes de horas de trabajo (conducción + paradas dentro de horario
      laboral) por tracker
  - name: Reportes - Última Actividad
    description: Reporte de estado de comunicación y última posición de activos
  - name: Reportes - Reportes Programados
    description: Gestión de reportes programados (CRUD)
  - name: Device Health
    description: Operaciones de salud de dispositivos del cliente
  - name: Activity Log
    description: Registro de actividad del cliente
  - name: Work - Importaciones
    description: Operaciones de importación de datos
  - name: Work - Plantillas
    description: Operaciones de plantillas de importación
  - name: Cargo - Transportistas
    description: Gestión de transportistas
  - name: Cargo - Pedidos
    description: Gestión de pedidos de carga
  - name: Cargo - Monitoreo
    description: Monitoreo en vivo de carga y transporte
  - name: Integraciones - Navixy
    description: Integración con plataforma Navixy
  - name: Mantenimiento - Dashboard
    description: Dashboard y métricas generales de mantenimiento
  - name: Mantenimiento - Proveedores
    description: Gestión de proveedores de servicio
  - name: Mantenimiento - Tareas
    description: Catálogo de tareas con que se arman las pautas de mantención
  - name: Mantenimiento - Pautas
    description: Pautas de mantención, con sus tareas del catálogo y su familia de activos
  - name: Mantenimiento - Estado
    description: Estado de mantenimiento de activos
  - name: Mantenimiento - Perfiles
    description: Perfiles de mantenimiento por activo
  - name: Mantenimiento - Fallas
    description: Gestión de fallas activas
  - name: Mantenimiento - DVIR
    description: Driver Vehicle Inspection Reports
  - name: Mantenimiento - Defectos
    description: Gestión de defectos detectados
  - name: Mantenimiento - Programaciones
    description: Programación de mantenimientos preventivos
  - name: Mantenimiento - Próximos
    description: Ítems de mantenimiento próximos
  - name: Mantenimiento - Órdenes de Trabajo
    description: Gestión de órdenes de trabajo
  - name: Mantenimiento - Registros de Servicio
    description: Registros históricos de servicios realizados
  - name: Mantenimiento - Problemas
    description: Gestión de problemas de mantenimiento
  - name: Mantenimiento - Tareas de Servicio
    description: Tareas específicas dentro de órdenes de trabajo
  - name: Mantenimiento - Inventario
    description: Gestión de partes, ubicaciones y stock
  - name: Mantenimiento - Costos
    description: Gestión y agregación de costos de mantenimiento
  - name: Trabajo - Tareas
    description: Gestión de tareas, tareas recurrentes, rutas y operaciones en lote
  - name: Trabajo - Empleados
    description: Gestión de empleados, departamentos y sus catálogos (tags, trackers)
  - name: Otros - Lugares
    description: Gestión de lugares (places) del cliente
  - name: Cargo - Activos
    description: Disponibilidad de activos de carga
  - name: Cargo - Ubicaciones
    description: Gestión de ubicaciones de carga
  - name: Cargo - Rendimiento
    description: Métricas de rendimiento de pedidos de carga
  - name: Reportes - Check-ins
    description: Reporte de check-ins de tareas
  - name: Reportes - Utilización
    description: Reporte de utilización de activos
  - name: Reportes - Visitas por Geocercas
    description: Reporte de visitas a geocercas
  - name: Reportes - Visitas por Trackers
    description: Reporte de visitas por tracker/activo
  - name: Reportes - Progreso de Geozonas
    description: Reporte de progreso de cobertura de geozonas (agricultura)
  - name: Reportes - Temperatura
    description: Reporte de temperatura por activo
  - name: Reportes - Exportación
    description: Exportación de reportes a archivo
  - name: Público - Business Time
    description: Reloj de servidor (endpoint público, sin autenticación)
  - name: Formularios
    description: Definiciones y envíos de formularios de la app
  - name: Sistema
    description: Endpoints de salud del servicio (liveness/readiness), sin autenticación
  - name: Facturación
    description: >-
      Portal del cliente — facturas publicadas de la empresa (proyección de
      Raúl)
  - name: Tienda de módulos
    description: >-
      Catálogo de módulos y productos UGPS con el estado de cada uno para el
      usuario
  - name: Soporte
    description: Portal del cliente — tickets de soporte de la empresa (proyección de Raúl)
  - name: Asistente
    description: Historial de conversaciones del Asistente de Atlas (spec
paths:
  /api/drivers/{id}/avatar:
    put:
      tags:
        - Otros - Conductores
      summary: Elegir un avatar predefinido para un conductor
      description: >
        Deja uno de los avatares predefinidos (inicial, silueta o ilustración de
        conductor, con su color) como avatar de la ficha. Si la ficha tenía una
        foto

        subida, la foto se borra. Queda en el Registro de actividades como
        edición del conductor.


        **Permisos requeridos:** `access_drivers`
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
          description: ID del recurso
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - presetKey
                - color
              properties:
                presetKey:
                  type: string
                  enum:
                    - initial
                    - man
                    - woman
                    - driverMan
                    - driverWoman
                    - driverManWheel
                    - driverWomanWheel
                    - driverManNoCap
                    - driverWomanNoCap
                    - driverManWheelNoCap
                    - driverWomanWheelNoCap
                    - person
                color:
                  type: string
                  pattern: ^#[0-9A-Fa-f]{6}$
                  example: '#2C8DDD'
                  description: Color del avatar, hexadecimal de seis dígitos.
      responses:
        '200':
          description: Avatar predefinido guardado
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: success
                  data:
                    type: object
                    properties:
                      rut:
                        type: string
                        description: >-
                          Se guarda sin puntos y con guion (`19821574-0`);
                          acepta cualquier escritura (`19.821.574-0`,
                          `198215740`).
                        example: 19821574-0
                      phone:
                        type: string
                      firstname:
                        type: string
                      lastname:
                        type: string
                      email:
                        type: string
                        description: >-
                          Opcional. Sin correo no se puede crear la cuenta de la
                          app; sí vincular una.
                      address:
                        type: string
                      city:
                        type: string
                      clientId:
                        type: string
                        description: Lo fija la sesión; se ignora si viene en el body.
                      userId:
                        type: string
                        description: >-
                          Cuenta Atlas vinculada para la app; ausente hasta su
                          primer ingreso con código.
                      portalStatus:
                        type: string
                        enum:
                          - active
                          - blocked
                          - pending
                          - noEmail
                        readOnly: true
                        description: >-
                          Solo en el listado. Estado del conductor en el portal
                          de reservas según la cuenta vinculada a la ficha,
                          `active` (su cuenta entra al portal), `blocked` (con
                          el portal deshabilitado), `pending` (tiene correo pero
                          su cuenta aún no entra al portal) o `noEmail` (la
                          ficha no tiene correo).
                      avatar:
                        type: object
                        readOnly: true
                        description: >-
                          Avatar de la ficha, un predefinido o una foto subida.
                          Ausente cuando el conductor no tiene avatar (la
                          interfaz muestra su inicial). Se cambia solo por
                          `/api/drivers/{id}/avatar`.
                        properties:
                          kind:
                            type: string
                            enum:
                              - preset
                              - upload
                          presetKey:
                            type: string
                            enum:
                              - initial
                              - man
                              - woman
                              - driverMan
                              - driverWoman
                              - driverManWheel
                              - driverWomanWheel
                              - driverManNoCap
                              - driverWomanNoCap
                              - driverManWheelNoCap
                              - driverWomanWheelNoCap
                              - person
                            description: >-
                              Solo con `kind: preset`. Avatar predefinido, la
                              inicial del nombre (`initial`), una silueta neutra
                              de hombre o de mujer (`man`, `woman`) o una
                              ilustración de conductor o conductora, con o sin
                              gorra y volante (`driver*`), o un icono genérico
                              de persona (`person`); cada interfaz la traduce a
                              su dibujo.
                          color:
                            type: string
                            pattern: ^#[0-9A-Fa-f]{6}$
                            example: '#2C8DDD'
                            description: >-
                              Solo con `kind: preset`. Color del avatar
                              predefinido, hexadecimal de seis dígitos.
                          url:
                            type: string
                            format: uri
                            description: 'Solo con `kind: upload`. URL pública de la foto.'
                            example: >-
                              https://files.ugps.io/avatars/6650f1c2a4b3c2d1e0f9a8b7/drivers/6650f1c2a4b3c2d1e0f9a8b8/3f2b1c9e-8a7d-4c6b-9e5f-1a2b3c4d5e6f.jpg
                        required:
                          - kind
                      createdAt:
                        type: string
                        format: date-time
                      updatedAt:
                        type: string
                        format: date-time
                    required:
                      - rut
                      - firstname
                      - lastname
        '400':
          description: Error de validación
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    properties:
                      error:
                        type: string
                        example: El email es requerido
                  - type: object
                    properties:
                      status:
                        type: string
                        example: failed
                      message:
                        type: string
                        example: Error de validación
                      errors:
                        type: array
                        items:
                          type: object
                          properties:
                            path:
                              type: string
                            message:
                              type: string
        '401':
          description: No autorizado
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Token inválido o expirado
        '403':
          description: Sin permisos
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: No tiene permisos para realizar esta acción
        '404':
          description: Recurso no encontrado
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Recurso no encontrado
        '500':
          description: Error interno del servidor
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    properties:
                      message:
                        type: string
                        example: Error interno del servidor
                  - type: object
                    properties:
                      status:
                        type: string
                        example: failed
                      message:
                        type: string
                        example: Error interno del servidor
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Token de sesión Better Auth o API token (`atk_...`) en el header
        `Authorization: Bearer <token>`. Los JWT legacy ya no son válidos.
    cookieAuth:
      type: apiKey
      in: cookie
      name: better-auth.session_token
      description: >-
        Cookie de sesión Better Auth emitida al iniciar sesión en el frontend
        web. En producción el nombre lleva prefijo `__Secure-`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.