エラーコード

OpenAPI 仕様から生成された、公開 API が現在返すすべてのエラーコードです。失敗レスポンスでは、エンベロープの error_code フィールドにコードが含まれます。

エラーコード	HTTP ステータス	返却元
`BUSINESS_LOCATION_MISSING`	400	create-technician, update-technician
`IDEMPOTENCY_KEY_INVALID`	400	create-webhook-endpoint
`INVALID_REQUEST_BODY`	400	book-and-confirm-job-request, commit-absence-resolve, commit-emergency-reschedule, commit-job-request-move, confirm-job-request, create-customer, create-job-request, create-job-type, create-service-area, create-skill, create-skill-category, create-technician, create-technician-time-off, create-vehicle, create-webhook-endpoint, delete-skill, delete-skill-category, 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-technician-time-off, list-technicians, list-vehicles, preview-absence-resolve, 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-job-type, update-service-area, update-skill, update-technician, update-vehicle
`INVALID_TIMEZONE`	400	create-job-request, list-job-request-booking-windows
`JOB_REQUEST_ADDRESS_REQUIRED`	400	book-and-confirm-job-request, create-job-request
`JOB_REQUEST_AFTER_HOURS_REQUIRES_TECHNICIAN`	400	confirm-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
`JOB_TYPE_INVALID_DEFAULT_DURATION`	400	create-job-type, update-job-type
`JOB_TYPE_INVALID_NAME`	400	create-job-type, update-job-type
`JOB_TYPE_INVALID_STATUS`	400	create-job-type, update-job-type
`PHONE_INVALID`	400	book-and-confirm-job-request, create-customer, create-technician, list-customers, update-customer, update-technician
`PHONE_OR_EMAIL_REQUIRED`	400	create-customer, update-customer
`SERVICE_AREA_INVALID_BOUNDARY`	400	create-service-area, update-service-area
`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
`TIME_OFF_END_BEFORE_START`	400	create-technician-time-off
`TIME_OFF_INVALID_DATE`	400	create-technician-time-off
`TIME_OFF_REASON_TOO_LONG`	400	create-technician-time-off
`VALIDATION_ERROR`	400	create-skill, create-skill-category, update-skill
`VEHICLE_INVALID_OWNER`	400	create-vehicle, update-vehicle
`VEHICLE_OWNER_TIER_NOT_ALLOWED`	400	create-vehicle, update-vehicle
`WEBHOOK_INVALID_EVENT`	400	create-webhook-endpoint
`WEBHOOK_INVALID_URL`	400	create-webhook-endpoint
`WEBHOOK_SECRET_EXPIRY_INVALID`	400	create-webhook-endpoint
`WRONG_QUERY`	400	list-customers, list-skill-categories, list-skills-by-category, list-technician-skills
`API_KEY_INVALID`	401	book-and-confirm-job-request, commit-absence-resolve, commit-emergency-reschedule, commit-job-request-move, confirm-job-request, create-job-request, create-webhook-endpoint, delete-webhook-endpoint, 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, list-technician-time-off, list-webhook-event-types, preview-absence-resolve, preview-emergency-reschedule, preview-job-request-move, quote-job-request, update-job-priority
`UNAUTHORIZED`	401	book-and-confirm-job-request, commit-absence-resolve, commit-emergency-reschedule, commit-job-request-move, confirm-job-request, create-customer, create-job-request, create-job-type, create-service-area, create-skill, create-skill-category, create-technician, create-technician-time-off, create-vehicle, create-webhook-endpoint, delete-customer, delete-job-type, delete-service-area, delete-skill, delete-skill-category, delete-technician, delete-vehicle, delete-webhook-endpoint, get-customer, get-job-request, get-job-request-timeline, get-job-type, get-service-area, get-technician, get-technician-schedule, get-vehicle, list-assignable-groups, 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-technician-time-off, list-technicians, list-vehicles, list-webhook-event-types, preview-absence-resolve, 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-job-type, update-service-area, update-skill, update-technician, update-vehicle
`FORBIDDEN`	403	list-assignable-groups, update-job-priority
`JOB_TYPE_SYSTEM_READ_ONLY`	403	delete-job-type, update-job-type
`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
`WEBHOOK_EVENT_NOT_PERMITTED`	403	create-webhook-endpoint
`BUSINESS_GROUP_NOT_FOUND`	404	create-technician, update-technician
`BUSINESS_NOT_FOUND`	404	create-customer, create-service-area
`CUSTOMER_NOT_FOUND`	404	book-and-confirm-job-request, 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	book-and-confirm-job-request, create-job-request, delete-job-type, get-job-type, update-job-type
`SERVICE_AREA_NOT_FOUND`	404	create-technician, delete-service-area, get-service-area, update-service-area
`SKILL_CATEGORY_NOT_FOUND`	404	create-skill, delete-skill-category, list-skills-by-category
`SKILL_NOT_FOUND`	404	book-and-confirm-job-request, create-job-request, delete-skill, replace-technician-skills, update-skill
`TECHNICIAN_NOT_FOUND`	404	commit-absence-resolve, create-technician, create-technician-time-off, delete-technician, get-technician, get-technician-schedule, list-technician-skills, preview-absence-resolve, replace-technician-buddies, replace-technician-service-areas, replace-technician-skills, replace-technician-vehicles, update-technician
`VEHICLE_NOT_FOUND`	404	delete-vehicle, get-vehicle, replace-technician-vehicles, update-vehicle
`WEBHOOK_NOT_FOUND`	404	delete-webhook-endpoint
`ABSENCE_RESOLVE_NO_ORPHANED_JOBS`	409	commit-absence-resolve
`CUSTOMER_DUPLICATE_EMAIL`	409	create-customer, update-customer
`CUSTOMER_DUPLICATE_LOCATION_ADDRESS`	409	update-customer
`CUSTOMER_DUPLICATE_PHONE`	409	create-customer, update-customer
`CUSTOMER_DUPLICATE_UID`	409	create-customer, update-customer
`EMERGENCY_RESCHEDULE_IN_PAST`	409	commit-emergency-reschedule, preview-emergency-reschedule
`IDEMPOTENCY_IN_PROGRESS`	409	book-and-confirm-job-request, create-job-request, create-webhook-endpoint
`JOB_REQUEST_AFTER_HOURS_CREW_UNSUPPORTED`	409	confirm-job-request
`JOB_REQUEST_AFTER_HOURS_MULTIDAY_UNSUPPORTED`	409	confirm-job-request
`JOB_REQUEST_AFTER_HOURS_REQUIRES_P0`	409	confirm-job-request
`JOB_REQUEST_INVALID_TRANSITION`	409	list-crew-candidates
`JOB_REQUEST_NO_TECHNICIAN_AVAILABLE`	409	list-crew-candidates
`JOB_TYPE_DUPLICATE`	409	create-job-type, update-job-type
`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
`SERVICE_AREA_DUPLICATE_NAME`	409	create-service-area, update-service-area
`SKILL_CATEGORY_DUPLICATE_NAME`	409	create-skill-category
`SKILL_CATEGORY_NOT_EMPTY`	409	delete-skill-category
`SKILL_DUPLICATE_NAME`	409	create-skill, update-skill
`SKILL_HAS_MEMBERS`	409	delete-skill
`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
`TIME_OFF_OVERLAP`	409	create-technician-time-off
`VEHICLE_DUPLICATE_NAME`	409	create-vehicle, update-vehicle
`VEHICLE_DUPLICATE_PLATE`	409	create-vehicle, update-vehicle
`WEBHOOK_LIMIT_REACHED`	409	create-webhook-endpoint
`IDEMPOTENCY_KEY_REUSE`	422	book-and-confirm-job-request

認証情報の有効期限

認証情報には有限の有効期間があります。以下のコードにより、有効期限切れを、無効化や誤った値と区別できます:

エラーコード	HTTP ステータス	意味
`API_KEY_EXPIRED`	401	API キーが有効期間を過ぎました — 代わりのキーを作成してください。`API_KEY_INVALID`（無効化・削除済み、または誤った値）とは意図的に区別されています。
`OAUTH_GRANT_EXPIRED`	401	OAuth 接続が失効しました（30 日間のアイドルウィンドウ、または絶対上限） — オーナーが同意画面からアプリを再承認する必要があります。
`API_KEY_SCOPE_NOT_GRANTED`	403	新しいキーが、作成者の保有する権限を超えるスコープをリクエストしました — 認証を参照してください。
`WEBHOOK_SECRET_EXPIRED`	409	署名シークレットが失効したエンドポイントに対して検証が呼び出されました — 先にシークレットをローテーションしてから検証してください。
`API_KEY_EXPIRY_INVALID`	400	リクエストされたキーの有効期間が 1〜365 日の範囲外です。
`WEBHOOK_SECRET_EXPIRY_INVALID`	400	リクエストされた Webhook 署名シークレットの有効期間が 1〜365 日の範囲外です。
`OAUTH_GRANT_LIFETIME_INVALID`	400	リクエストされた MCP 接続の有効期間上限が 1〜365 日の範囲外です。

緊急ディスパッチ

緊急ディスパッチのエンドポイントは、独自のコードを追加します。

エラーコード	HTTP ステータス	意味
`EMERGENCY_RESCHEDULE_INVALID_INPUT`	400	緊急プレビューのリクエストボディがバリデーションに失敗しました。

‹エラーとレスポンスエンベロープ

顧客一覧の取得›