Sign in

v1

latestOpenAPI 3.0.12026-07-243124341009.5 KB
Timesheets

Update Daily TimeSheet

Creates or updates a daily timesheet entry for a specific placement and day. Supports daily hours and mobile punch time capture methods with multiple breaks per day.

put/v1/timesheets/daily

Headers

RequestIdstring uuid

The unique request identifier used to correlate request data with log entries and events, formatted as a UUID.

Unique request identifier (UUID) used to correlate request data with log entries and events.

FrontOfficeTenantIdinteger

An integer identifier for the tenant that the request is being made for. Required when Tenant header is not provided.

Tenantstring

Tenant company code that determines data access scope during the request. Required when FrontOfficeTenantId header is not provided.

Request body

dayWorkedstring date-time required

The date for the time entry. This should be just a date stamp. No time should be included.

timeInstring

The start time of the day. Format: 12-hour format (e.g., "9:00 AM"). Optional for "Saved" status, required for "Submitted" and "Approved" statuses.

timeOutstring

The end time of the day. Format: 12-hour format (e.g., "5:00 PM"). Optional for "Saved" status, required for "Submitted" and "Approved" statuses. Supports overnight shifts where TimeOut appears earlier than TimeIn.

placementIdinteger required

The identifier for the placement. It allows the timesheet to be correlated with the talent to whom the time belongs.

statusstring required

The status of the timesheet. Accepted Values are: Saved, Submitted and Approved.

  • "Saved": Allows partial time entry (flexible validation)
  • "Submitted": Requires all times to be present and valid
  • "Approved": Requires all times to be present and valid
useRoundingboolean

Whether to round time values to the configured timesheet minute spread.

  • false: Validates that time values match the configured timesheet minute spread exactly
  • true: Automatically rounds time values to the nearest configured minute spread

Response

The daily timesheet entry that was successfully created or updated.

successboolean

Indicates if the operation was successful.

statusCode'Success' | 'BadRequest' | 'NotFound' | 'Unauthorized' | 'Forbidden' | 'Conflict' | 'InternalServerError' | 'FeatureNotAvailable'

Status codes for service operation results.

errorstring

Primary error message (present on failures).

messagesstring[]

Array of informational messages about the operation.

warningsstring[]

Array of non-blocking warning messages for potential issues.

correctionsstring[]

Auto-corrections made by the system (e.g., time format corrections).

requestIdstring

Unique request identifier for error tracking and debugging.