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

# Registrar usuario con email y password



## OpenAPI

````yaml /docs/openapi-auth.yaml post /api/register
openapi: 3.0.3
info:
  title: CamellApp API
  version: 1.0.0
  description: |
    Documentacion Swagger de autenticacion, perfil, camellos publicos,
    trabajos (jobs), salud del sistema y administracion (usuarios, servicios,
    categorias, camellos, notificaciones).
    Autenticacion por cookie de sesion NextAuth (`next-auth.session-token`).
servers:
  - url: http://localhost:3000
    description: Local
security: []
tags:
  - name: Auth
    description: Registro y autenticacion (NextAuth)
  - name: Me
    description: Perfil del usuario autenticado
  - name: Camellos
    description: Listado publico de camellos activos y reseñas
  - name: Categories
    description: Categorias publicas
  - name: Search
    description: Interpretacion de busquedas en lenguaje natural (publico)
  - name: Health
    description: Estado del sistema (probe publico y snapshot admin)
  - name: Admin Users
    description: Administracion de usuarios (solo ADMIN)
  - name: Admin Services
    description: Administracion de servicios (solo ADMIN)
  - name: Admin Categories
    description: Administracion de categorias (solo ADMIN)
  - name: Admin Camellos
    description: Administracion de camellos (solo ADMIN)
  - name: Admin Meta
    description: Utilidades admin (OpenAPI)
  - name: Notifications
    description: Inbox y preferencias del usuario autenticado
  - name: Admin Notifications
    description: Centro de envios (solo ADMIN)
  - name: Jobs
    description: Solicitudes de trabajo del usuario autenticado
  - name: Admin Jobs
    description: Asignacion de trabajos (solo ADMIN)
paths:
  /api/register:
    post:
      tags:
        - Auth
      summary: Registrar usuario con email y password
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RegisterRequest'
            examples:
              cliente:
                value:
                  name: Juan Perez
                  email: juan@demo.com
                  password: ClaveSegura123!
                  phone: '3001234567'
                  role: CLIENTES
                  acceptTerms: true
              profesional:
                value:
                  name: Ana Camello
                  email: ana@demo.com
                  password: ClaveSegura123!
                  phone: '3109876543'
                  role: CAMELLOS
                  acceptTerms: true
      responses:
        '201':
          description: Usuario creado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RegisterResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '409':
          description: Email ya registrado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          $ref: '#/components/responses/ServerError'
components:
  schemas:
    RegisterRequest:
      type: object
      properties:
        name:
          type: string
          minLength: 2
          maxLength: 120
        email:
          type: string
          format: email
        password:
          type: string
          minLength: 8
          maxLength: 128
        phone:
          type: string
          minLength: 7
          maxLength: 32
        role:
          type: string
          enum:
            - CLIENTES
            - CAMELLOS
        acceptTerms:
          type: boolean
          enum:
            - true
      required:
        - name
        - email
        - password
        - phone
        - role
        - acceptTerms
    RegisterResponse:
      type: object
      properties:
        user:
          type: object
          required:
            - id
            - email
            - role
            - createdAt
          properties:
            id:
              type: string
            name:
              type: string
              nullable: true
            email:
              type: string
              format: email
            role:
              $ref: '#/components/schemas/Role'
            createdAt:
              type: string
              format: date-time
      required:
        - user
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
          example: Sin permisos de administrador
        issues:
          type: object
          nullable: true
        detail:
          type: string
          nullable: true
      required:
        - error
    Role:
      type: string
      enum:
        - ADMIN
        - CAMELLOS
        - CLIENTES
  responses:
    BadRequest:
      description: Datos o parametros invalidos
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    ServerError:
      description: Error interno
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'

````