Skip to main content

Update Repair Settings

PUT 

/api/repairs/settings/general

Saves repair and warranty settings and returns the full settings after saving.

Required scope: repairs:write

Grant 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​

OK

Response Headers
    Content-Type