🚀 New Endpoints & Enhancements

We’re excited to announce several new updates and improvements across our Time Off and Timesheets APIs to make your integrations more powerful and flexible. Below is a detailed breakdown of the latest changes:

✨ Time Off API Enhancements

🔹 Create Time Off

Endpoint: POST /rest/v2/time-offs
Scopes: time-off:write
Allowed Tokens:
OAUTH2:ORGANIZATIONAL, OAUTH2:PERSONAL, PAT:ORGANIZATIONAL, PAT:PERSONAL

What’s new:

• ✅ You can now request time-offs using only the policy_id, removing the need to specify a time_off_type_id.
• 🕒 Support added for requesting time-offs with a PENDING status.
• 📅 The start_date and end_date fields now accept both YYYY-MM-DD and ISO 8601 date formats. We recommend using YYYY-MM-DD for consistency.
• 📎 File attachments are now supported when submitting requests via multipart/form-data.

🔹 Update Time Off

Endpoint: PATCH /rest/v2/time-offs/:id
Scopes: time-off:write
Allowed Tokens:
OAUTH2:ORGANIZATIONAL, OAUTH2:PERSONAL, PAT:ORGANIZATIONAL, PAT:PERSONAL

What’s new:

• ✅ Time-off updates now support using only the policy_id, removing the requirement for time_off_type_id.
• 📅 Updated support for start_date and end_date parameters in both YYYY-MM-DD and ISO string formats (we recommend YYYY-MM-DD).
• 📎 Edit time-offs with file attachments using multipart/form-data.

🆕 New Endpoint: Daily Time Off Configurations

Endpoint: GET /rest/v2/time-offs/dailies
Scopes: time-off:read
Allowed Tokens:
OAUTH2:ORGANIZATIONAL, OAUTH2:PERSONAL, PAT:ORGANIZATIONAL, PAT:PERSONAL

What it does:
Fetch comprehensive daily information for a given date range tied to an hrisProfile:

• 🗓 Work Schedule: Breakdown of working hours by weekday.
• 🎉 Holidays: Holidays occurring within the specified date range.
• 📘 Time Off Dailies: Daily records including holiday or work status.

⏱ Timesheets API – New Endpoints for Hourly Report Root Presets

🆕 Create Hourly Report Root Preset

Endpoint: POST /rest/v2/timesheets/root-presets
Scopes: timesheets:write
Allowed Tokens:
OAUTH2:ORGANIZATIONAL, OAUTH2:PERSONAL, PAT:ORGANIZATIONAL, PAT:PERSONAL

Create a new root preset for hourly reports to streamline your reporting setup.

🆕 Get All Hourly Report Root Presets

Endpoint: GET /rest/v2/timesheets/root-presets
Scopes: timesheets:read
Allowed Tokens:
OAUTH2:ORGANIZATIONAL, OAUTH2:PERSONAL, PAT:ORGANIZATIONAL, PAT:PERSONAL

Retrieve a list of all existing hourly report root presets.

🆕 Get a Specific Hourly Report Root Preset

Endpoint: GET /rest/v2/timesheets/root-presets/:id
Scopes: timesheets:read
Allowed Tokens:
OAUTH2:ORGANIZATIONAL, OAUTH2:PERSONAL, PAT:ORGANIZATIONAL, PAT:PERSONAL

Fetch detailed information about a specific preset by ID.