API documentation

PUT /state_holidays/:id

Authorization Required

https://[your-subdomain].trackdrive.com/api/v1/state_holidays/:id

Update State Holiday by id.

Change the states or holiday dates on an existing rule. System-provided template rules cannot be modified.

Params

Param name Description

Param name	Description
states Optional Blank value allowed	States Must be an array of strings. EG: `["abc123", "xzy023"]`
holiday_dates Optional Blank value allowed	Holiday Dates Must be an array of strings. EG: `["abc123", "xzy023"]`
name Optional Blank value allowed	Name Must be a String

states
Optional Blank value allowed

States

Must be an array of strings. EG: ["abc123", "xzy023"]

holiday_dates
Optional Blank value allowed

Holiday Dates

Must be an array of strings. EG: ["abc123", "xzy023"]

name
Optional Blank value allowed

Name

Must be a String

Example Request

curl -X PUT 'https://[your-subdomain].trackdrive.com/api/v1/state_holidays/a6af7847-1b1e-4760-ac0d-e1813a6d3a09' \
  -H 'Authorization: Basic BASE64_ENCODED_PUBLIC_KEY_AND_PRIVATE_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Example State Holiday (renamed)"
}'

Example Response 200

{
  "status": 200,
  "success": true,
  "errors": {},
  "state_holiday": {
    "id": "a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
    "type": "StateHoliday",
    "uuid": "a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
    "created_at": "2026-01-15T15:30:00.000Z",
    "updated_at": "2026-01-15T15:30:00.000Z",
    "deleted_at": null,
    "user_updated_at": null,
    "routes_show_path": "/state_holidays/a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
    "routes_edit_path": "/state_holidays/a6af7847-1b1e-4760-ac0d-e1813a6d3a09/edit",
    "external_record_id": null,
    "company_id": 10001,
    "states": [
      "us-ca"
    ],
    "name": "Example State Holiday (renamed)",
    "holiday_dates": [
      "2026-01-14",
      "2026-01-15"
    ],
    "is_system_template": false
  },
  "metadata": {
    "root": "state_holiday"
  }
}