Update Repair Settings
PUT/api/repairs/settings/general
Saves repair and warranty settings and returns the full settings after saving.
repairs:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Authentication: Requires Bearer token with the repairs write scope and the repairs.manage_settings permission.
Fields (all optional; only the fields sent change):
- numbering_prefix (string, 1-10 letters/numbers): repair numbers read {prefix}-{year}-{seq}.
- auto_accept_portal_claims, auto_create_rma, ai_assist, delay_notifications_automatic, portal_enabled, portal_allow_video, shopify_order_note_tag, registration_number_from_serial (boolean).
- auto_close_days, awaiting_item_auto_cancel_days (integer 1-365 or null to turn off).
- refurbish_costing: capitalize | expense. reserve_accounting: off | accrue. technician_assignment: manual | round_robin. sla_start: received | submitted.
- risk_max_claims_per_year (1-1000), risk_wear_and_tear_min_days (0-3650), risk_early_claim_days (0-3650), timer_daily_cap_hours (1-24) (integer).
- auto_approve_max_value, inspection_min_value (number >= 0; inspection_min_value must be at least auto_approve_max_value).
- quote_expiry_days (1-365), quote_reminder_days (array of integers 1-365, max 10), quote_email_confirmation_threshold (number or null).
- delay_threshold_days, survey_delay_days, loaner_due_days, abandoned_goods_days, credit_redemption_alert_days, quality_alert_min_claims (integer). quality_alert_multiplier (number 1-100). abandoned_goods_policy_text (string, max 5000, nullable).
- portal_intro_text (string, max 5000), portal_turnaround_text (string, max 500), portal_required_photo_count (integer 0-3), portal_drop_off_warehouse_ids (array of warehouse IDs; each must be one of your own (direct) warehouses or stores, not archived and not a contractor's, since customers hand pieces in there; marketplace (FBA, WFS), 3PL and supplier warehouses are rejected with 422, and the settings read lists only the ones that still qualify), claims_default_warehouse_id (warehouse ID or null).
- repair_excluded_product_ids (array of product IDs never sent to repair).
- registration_auto_verify_confidence (number 0-1 or null; 0.9 = 90%).
- plating_finish_attribute_names (array of strings), plating_finish_suffixes (object of SKU suffix -> finish name).
- default_package (object): weight, length, width, height (number > 0), weight_unit (lb|oz|kg|g), dimension_unit (in|cm). Keys not sent keep their value.
Labour rates (default_labour_cost_rate, technician_labour_rates, labour_bill_rate) are read-only here; change them with PUT /api/repairs/settings/rates.
Request
Responses
- 200
- 401
- 403
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Unprocessable Content
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.