Codes d’erreur

Tous les codes d’erreur actuellement renvoyés par l’API publique, générés à partir de la spécification OpenAPI. Une réponse en échec porte le code dans le champ error_code de l’enveloppe.

Code d’erreur	Statut HTTP	Renvoyé par
`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

Expiration des identifiants

Les identifiants ont une durée de vie finie ; ces codes distinguent une expiration d’une révocation ou d’une valeur incorrecte :

Code d’erreur	Statut HTTP	Signification
`API_KEY_EXPIRED`	401	La clé API a dépassé sa durée de vie — créez une clé de remplacement. Délibérément distinct de `API_KEY_INVALID` (révoquée, supprimée ou incorrecte).
`OAUTH_GRANT_EXPIRED`	401	La connexion OAuth est arrivée à échéance (fenêtre d’inactivité de 30 jours ou plafond absolu) — le propriétaire doit approuver à nouveau l’application depuis l’écran de consentement.
`API_KEY_SCOPE_NOT_GRANTED`	403	La nouvelle clé demandait des portées au-delà de celles que détient son créateur — voir Authentification.
`WEBHOOK_SECRET_EXPIRED`	409	Vérifier a été appelé sur un endpoint dont le secret de signature est arrivé à expiration — effectuez d’abord une rotation du secret, puis vérifiez.
`API_KEY_EXPIRY_INVALID`	400	La durée de vie de clé demandée est en dehors de la plage 1–365 jours.
`WEBHOOK_SECRET_EXPIRY_INVALID`	400	La durée de vie demandée pour le secret de signature de webhook est en dehors de la plage 1–365 jours.
`OAUTH_GRANT_LIFETIME_INVALID`	400	Le plafond de durée de vie de connexion MCP demandé est en dehors de la plage 1–365 jours.

Interventions d’urgence (préversion privée)

La surface en préversion des interventions d’urgence ajoute ses propres codes pendant la préversion privée :

Code d’erreur	Statut HTTP	Signification
`EMERGENCY_RESCHEDULE_INVALID_INPUT`	400	Le corps de la requête de préversion d’urgence a échoué à la validation.

‹Erreurs et enveloppe de réponse

Lister les clients›