Códigos de error

Todos los códigos de error que actualmente devuelve la API pública, generados a partir de la especificación OpenAPI. Una respuesta fallida incluye el código en el campo error_code del sobre.

Código de error	Estado HTTP	Devuelto por
`BUSINESS_LOCATION_MISSING`	400	create-technician, update-technician
`EMERGENCY_RESCHEDULE_INVALID_INPUT`	400	commit-emergency-reschedule, list-emergency-candidates, preview-emergency-reschedule
`INVALID_REQUEST_BODY`	400	commit-emergency-reschedule, commit-job-request-move, confirm-job-request, create-customer, create-job-request, create-technician, get-job-request, get-job-request-timeline, get-technician-schedule, list-emergency-candidates, list-job-request-booking-windows, list-job-request-changes, list-job-requests, list-job-types, list-service-areas, list-skills-by-category, list-technician-skills, list-technicians, list-vehicles, preview-emergency-reschedule, preview-job-request-move, quote-job-request, replace-technician-buddies, replace-technician-leads, replace-technician-service-areas, replace-technician-skills, replace-technician-vehicles, update-customer, update-job-priority, update-technician
`INVALID_TIMEZONE`	400	create-job-request, list-job-request-booking-windows
`JOB_REQUEST_ADDRESS_REQUIRED`	400	create-job-request
`JOB_REQUEST_INVALID_INPUT`	400	confirm-job-request, create-job-request, get-technician-schedule, list-crew-candidates, list-matching-slots, list-nearby-technicians, quote-job-request, update-job-priority
`PHONE_INVALID`	400	create-customer, create-technician, update-customer, update-technician
`PHONE_OR_EMAIL_REQUIRED`	400	create-customer
`SCHEDULE_MOVE_INVALID_INPUT`	400	commit-job-request-move, preview-job-request-move
`TECHNICIAN_CONTACT_REQUIRED`	400	create-technician, update-technician
`TECHNICIAN_INVALID_BUDDY`	400	replace-technician-buddies, replace-technician-leads
`TECHNICIAN_INVALID_TIER`	400	create-technician, update-technician
`WRONG_QUERY`	400	list-customers, list-skill-categories, list-skills-by-category, list-technician-skills
`API_KEY_INVALID`	401	commit-emergency-reschedule, commit-job-request-move, confirm-job-request, create-job-request, get-job-request, get-technician-schedule, list-crew-candidates, list-emergency-candidates, list-job-request-booking-windows, list-job-request-changes, list-job-requests, list-matching-slots, list-nearby-technicians, preview-emergency-reschedule, preview-job-request-move, quote-job-request, update-job-priority
`UNAUTHORIZED`	401	commit-emergency-reschedule, commit-job-request-move, confirm-job-request, create-customer, create-job-request, create-technician, delete-customer, delete-technician, get-customer, get-job-request, get-job-request-timeline, get-job-type, get-service-area, get-technician, get-technician-schedule, get-vehicle, list-crew-candidates, list-customers, list-emergency-candidates, list-job-request-booking-windows, list-job-request-changes, list-job-requests, list-job-types, list-matching-slots, list-nearby-technicians, list-service-areas, list-skill-categories, list-skills, list-skills-by-category, list-technician-skills, list-technicians, list-vehicles, preview-emergency-reschedule, preview-job-request-move, quote-job-request, replace-technician-buddies, replace-technician-leads, replace-technician-service-areas, replace-technician-skills, replace-technician-vehicles, update-customer, update-job-priority, update-technician
`FORBIDDEN`	403	update-job-priority
`SANDBOX_MANAGEMENT_ROLE_FORBIDDEN`	403	create-technician, update-technician
`TECHNICIAN_GROUP_NOT_ASSIGNABLE`	403	create-technician, update-technician
`TECHNICIAN_ROLE_API_KEY_FORBIDDEN`	403	create-technician, update-technician
`TECHNICIAN_TARGET_NOT_MANAGEABLE`	403	create-technician, update-technician
`BUSINESS_GROUP_NOT_FOUND`	404	create-technician, update-technician
`BUSINESS_NOT_FOUND`	404	create-customer
`CUSTOMER_NOT_FOUND`	404	create-job-request, delete-customer, get-customer, update-customer
`JOB_REQUEST_NOT_FOUND`	404	commit-emergency-reschedule, commit-job-request-move, confirm-job-request, get-job-request, get-job-request-timeline, list-crew-candidates, list-emergency-candidates, list-matching-slots, preview-emergency-reschedule, preview-job-request-move, quote-job-request, update-job-priority
`JOB_TYPE_NOT_FOUND`	404	create-job-request, get-job-type
`SERVICE_AREA_NOT_FOUND`	404	create-technician, get-service-area
`SKILL_CATEGORY_NOT_FOUND`	404	list-skills-by-category
`SKILL_NOT_FOUND`	404	create-job-request, replace-technician-skills
`TECHNICIAN_NOT_FOUND`	404	create-technician, delete-technician, get-technician, get-technician-schedule, list-technician-skills, replace-technician-buddies, replace-technician-service-areas, replace-technician-skills, replace-technician-vehicles, update-technician
`VEHICLE_NOT_FOUND`	404	get-vehicle, replace-technician-vehicles
`CUSTOMER_DUPLICATE_EMAIL`	409	create-customer, update-customer
`CUSTOMER_DUPLICATE_PHONE`	409	create-customer, update-customer
`CUSTOMER_DUPLICATE_UID`	409	create-customer
`EMERGENCY_RESCHEDULE_CREW_UNSUPPORTED`	409	commit-emergency-reschedule, preview-emergency-reschedule
`EMERGENCY_RESCHEDULE_IN_PAST`	409	commit-emergency-reschedule, preview-emergency-reschedule
`EMERGENCY_RESCHEDULE_MULTIDAY_UNSUPPORTED`	409	commit-emergency-reschedule, preview-emergency-reschedule
`EMERGENCY_RESCHEDULE_NO_WORKING_DAY`	409	commit-emergency-reschedule, preview-emergency-reschedule
`EMERGENCY_RESCHEDULE_NOT_ELIGIBLE`	409	commit-emergency-reschedule, preview-emergency-reschedule
`IDEMPOTENCY_IN_PROGRESS`	409	create-job-request
`JOB_REQUEST_NO_TECHNICIAN_AVAILABLE`	409	list-crew-candidates
`SCHEDULE_MOVE_CREW_UNSTAFFABLE`	409	commit-job-request-move, preview-job-request-move
`SCHEDULE_MOVE_IN_PAST`	409	commit-job-request-move, preview-job-request-move
`SCHEDULE_MOVE_IN_PROGRESS`	409	commit-job-request-move, preview-job-request-move
`SCHEDULE_MOVE_MULTIDAY_UNSUPPORTED`	409	commit-job-request-move, preview-job-request-move
`SCHEDULE_MOVE_NO_WORKING_DAY`	409	commit-job-request-move, preview-job-request-move
`SCHEDULE_MOVE_NOT_ELIGIBLE`	409	commit-job-request-move, preview-job-request-move
`SCHEDULE_MOVE_PLAN_DRIFTED`	409	commit-job-request-move
`SCHEDULE_MOVE_REQUIRES_FREE_SLOT`	409	commit-job-request-move, preview-job-request-move
`SCHEDULE_MOVE_SLOT_OCCUPIED`	409	commit-job-request-move, preview-job-request-move
`SCHEDULE_MOVE_TECH_INFEASIBLE`	409	commit-job-request-move, preview-job-request-move
`SKILL_INACTIVE`	409	create-job-request, replace-technician-skills
`TECHNICIAN_ALREADY_MEMBER`	409	create-technician
`TECHNICIAN_DUPLICATE_EMAIL`	409	create-technician, update-technician
`TECHNICIAN_DUPLICATE_PHONE`	409	create-technician, update-technician
`TECHNICIAN_IDENTITY_CONFLICT`	409	create-technician
`TECHNICIAN_LAST_OWNER`	409	delete-technician

Expiración de credenciales

Las credenciales tienen duraciones finitas; estos códigos permiten distinguir una expiración de una revocación o de un valor incorrecto:

Código de error	Estado HTTP	Significado
`API_KEY_EXPIRED`	401	La clave de API superó su duración — cree una clave de reemplazo. Deliberadamente distinto de `API_KEY_INVALID` (revocada, eliminada o incorrecta).
`OAUTH_GRANT_EXPIRED`	401	La conexión OAuth caducó (ventana de inactividad de 30 días o el tope absoluto) — el propietario debe aprobar la aplicación de nuevo desde la pantalla de consentimiento.
`API_KEY_SCOPE_NOT_GRANTED`	403	La clave nueva solicitó alcances más allá de los que posee su creador — vea Autenticación.
`WEBHOOK_SECRET_EXPIRED`	409	Se llamó a Verificar en un endpoint cuyo secreto de firma caducó — rote el secreto primero y luego verifique.
`API_KEY_EXPIRY_INVALID`	400	La duración de clave solicitada está fuera de 1–365 días.
`WEBHOOK_SECRET_EXPIRY_INVALID`	400	La duración solicitada del secreto de firma de webhook está fuera de 1–365 días.
`OAUTH_GRANT_LIFETIME_INVALID`	400	El tope de duración de conexión MCP solicitado está fuera de 1–365 días.

Despacho de emergencia (vista previa privada)

La superficie de vista previa de despacho de emergencia añade sus propios códigos mientras está en vista previa privada:

Código de error	Estado HTTP	Significado
`EMERGENCY_RESCHEDULE_INVALID_INPUT`	400	El cuerpo de la solicitud de vista previa de emergencia no superó la validación.

‹Errores y sobre de respuesta

Listar clientes›