Crear conductor

POST

/drivers

curl --request POST \
  --url https://api.dev.lade.com.mx/drivers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "teamId": "550e8400-e29b-41d4-a716-446655440000", "name": "Pedro López", "phone": "+5212345678901", "licenseNumber": "ABC123456", "licenseExpiry": "2025-12-31" }'

• Development environment (dominio custom)
• QA environment
• Production environment
• Development environment (legacy — execute-api URL directo)

Registra un nuevo conductor para el equipo

Authorizations

• cognitoAuth

Request Body^required

Media typeapplication/json

object

teamId

required

string format: uuid

name

required

string

>= 1 characters <= 100 characters

phone

string

<= 20 characters

licenseNumber

string

<= 50 characters

licenseExpiry

string

<= 20 characters

curp

string

<= 18 characters

rfc

string

<= 13 characters

birthDate

string

<= 20 characters

address

object

street

string

<= 300 characters

extNumber

string

<= 50 characters

intNumber

string

<= 50 characters

neighborhood

string

<= 100 characters

city

string

<= 100 characters

state

string

<= 100 characters

country

string

default: Mexico <= 100 characters

zipCode

string

<= 10 characters

certifications

Array<string>

salary

number

0 <= 9999999

Example

{
  "teamId": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Pedro López",
  "phone": "+5212345678901",
  "licenseNumber": "ABC123456",
  "licenseExpiry": "2025-12-31"
}

Responses

201

Conductor creado

Media typeapplication/json

object

id

string format: uuid

teamId

string format: uuid

name

string

phone

string

nullable

photoUrl

string

nullable

status

Estado del conductor

string

Allowed values: DISPONIBLE EN_VIAJE NO_DISPONIBLE VACACIONES BAJA

licenseNumber

string

nullable

licenseExpiry

string

nullable

curp

string

nullable <= 18 characters

rfc

string

nullable <= 13 characters

birthDate

string

nullable

medicalExpiry

string

nullable

bloodType

string

nullable

emergencyContact

string

nullable

certifications

Array<string>

salary

number

address

object

street

string

<= 300 characters

extNumber

string

<= 50 characters

intNumber

string

<= 50 characters

neighborhood

string

<= 100 characters

city

string

<= 100 characters

state

string

<= 100 characters

country

string

default: Mexico <= 100 characters

zipCode

string

<= 10 characters

createdAt

string format: date-time

username

Usuario autogenerado para login en la app de conductores (ver POST /teams/{teamId}/drivers/{driverId}/access)

string

nullable

appAccessStatus

Estado de la cuenta del conductor en el pool de Cognito de la app móvil

string

Allowed values: NONE INVITED ACTIVE DISABLED

allergies

string

nullable

Example

{
  "status": "DISPONIBLE",
  "address": {
    "country": "Mexico"
  },
  "appAccessStatus": "NONE"
}

400

Solicitud inválida

Media typeapplication/json

object

error

required

string

message

string

field

string

Example

{
  "error": "Validation failed",
  "field": "email",
  "message": "Invalid email format"
}

401

No autenticado

Media typeapplication/json

object

error

required

string

message

string

field

string

Example

{
  "error": "Unauthorized",
  "message": "Invalid or expired token"
}

403

Sin permisos

Media typeapplication/json

object

error

required

string

message

string

field

string

Example

{
  "error": "Forbidden",
  "message": "You don't have permission to access this resource"
}