Cambiar el estado de una caja

PUT

/teams/{teamId}/boxes/{boxId}/status

curl --request PUT \
  --url https://api.dev.lade.com.mx/teams/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/boxes/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/status \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "status": "MANTENIMIENTO" }'

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

Cambia el status de una caja directamente (mantenimiento, desactivación, reactivación manual, etc. — separado de las transiciones automáticas que disparan las reservas). Registra auditoría con acción ACTIVATE/DEACTIVATE/UPDATE según la transición.

Authorizations

• cognitoAuth

Parameters

Path Parameters

teamId

required

string format: uuid

ID del equipo (UUID)

boxId

required

string format: uuid

ID de la caja (UUID)

Request Body^required

Media typeapplication/json

object

status

required

string

Allowed values: DISPONIBLE EN_VIAJE APARTADA RENTADA MANTENIMIENTO DESACTIVADA

Example

{
  "status": "MANTENIMIENTO"
}

Responses

200

Estado actualizado

Media typeapplication/json

object

message

string

boxId

string format: uuid

previousStatus

string

newStatus

string

Example

{
  "message": "Box status updated successfully",
  "boxId": "bb0e8400-e29b-41d4-a716-446655440006",
  "previousStatus": "DISPONIBLE",
  "newStatus": "MANTENIMIENTO"
}

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"
}

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"
}

404

Recurso no encontrado

Media typeapplication/json

object

error

required

string

message

string

field

string

Example

{
  "error": "Not found",
  "message": "Resource not found"
}