Zum Inhalt springen
Leadtime
Deutsch
Esc
↑↓navigieren↵öffnen⌘Jvorschau

Update holiday settings

Updates the default holiday country/region code for the workspace.

What this does: Sets the default holiday source that will be automatically applied to all new employees. This ensures consistent holiday rules across your workspace while still allowing individual customization.

Important:

  • This only affects new employees - existing employees keep their current holiday settings
  • The country code must be one of the available codes from GET /holidays/countries
  • Examples: “US” (United States), “DE” (Germany), “US-CA” (California), “AT” (Austria)

Use cases:

  • Setting up a new workspace with a primary location
  • Changing the default for a workspace that has moved or expanded to a new region
  • Standardizing holiday rules across the organization
PUT/holidays/settings
Authorization
AuthorizationOAuth2 access token · headerrequired
Scopes:api:write
or
AuthorizationBearer token (JWT) · headerrequired
Request body
requiredapplication/json
defaultHolidayCodestringrequired

The default holiday country/region code to set for the workspace. Must be one of the available codes from GET /holidays/countries. Examples: "US" (United States), "DE" (Germany), "US-CA" (California), "AT" (Austria). This setting only affects new employees - existing employees keep their current holiday settings.

Responses
200

Holiday settings updated successfully

401

Unauthorized - Invalid or missing authentication token

403

Forbidden - Insufficient API scopes or permissions

Try it
Server
Authorization
Bodyapplication/json
Request
curl -X PUT "https://leadtime.app/api/public/holidays/settings" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "defaultHolidayCode": "US"
}'
Response
Holiday settings updated successfully