Skip to content

TimeSheetDay​

Per-day time-sheet rows. Cover the workflow (draft → submitted → approved/declined) and manual overrides on top of the server-computed daily totals.


OpenAPI Spec​

GET
/v2/time-sheet-days/spec

Get OpenAPI 3.1.0 spec for TimeSheetDay API

Responses​

Returns OpenAPI 3.1.0 spec for TimeSheetDay API

application/json
JSON
{
}

Playground​

Samples​


List TimeSheetDays​

GET
/v2/time-sheet-days

List TimeSheetDays

Authorizations​

apiKey
Type
HTTP (bearer)

Parameters​

Query Parameters

page
Type
number
Minimum
0
Default
0
size
Type
number
Minimum
1
Maximum
20
Default
10
uuid
userUuid
day
status
submittedAt
approvedAt
externalId
createdAt
updatedAt

Responses​

List response

application/json
JSON
{
  
"page": 0,
  
"pages": 0,
  
"size": 10,
  
"items": [
  
  
{
  
  
  
"uuid": "string",
  
  
  
"userUuid": "string",
  
  
  
"day": "string",
  
  
  
"status": "string",
  
  
  
"note": "string",
  
  
  
"declinedNote": "string",
  
  
  
"startsAt": "string",
  
  
  
"endsAt": "string",
  
  
  
"breakTime": 0,
  
  
  
"duration": 0,
  
  
  
"startsAtManual": "string",
  
  
  
"endsAtManual": "string",
  
  
  
"breakTimeManual": 0,
  
  
  
"durationManual": 0,
  
  
  
"expectedDuration": 0,
  
  
  
"breakTimeErrorType": "string",
  
  
  
"breakTimeErrorExpected": 0,
  
  
  
"breakTimeErrorValue": 0,
  
  
  
"breakTimeErrorDurationMin": 0,
  
  
  
"durationErrorExpected": 0,
  
  
  
"durationErrorValue": 0,
  
  
  
"submittedAt": "string",
  
  
  
"submittedFirstAt": "string",
  
  
  
"approvedAt": "string",
  
  
  
"declinedAt": "string",
  
  
  
"manipulatedAt": "string",
  
  
  
"approvedByUuid": "string",
  
  
  
"declinedByUuid": "string",
  
  
  
"manipulatedByUuid": "string",
  
  
  
"externalId": "string",
  
  
  
"createdAt": "string",
  
  
  
"updatedAt": "string"
  
  
}
  
]
}

Playground​

Server
Authorization
Variables
Key
Value

Samples​


Create a new TimeSheetDay​

POST
/v2/time-sheet-days

Create a new TimeSheetDay

Authorizations​

apiKey
Type
HTTP (bearer)

Request Body​

application/json
JSON
{
  
"uuid": "string",
  
"userUuid": "string",
  
"day": "string",
  
"status": "string",
  
"note": "string",
  
"declinedNote": "string",
  
"startsAtManual": "string",
  
"endsAtManual": "string",
  
"breakTimeManual": 0,
  
"durationManual": 0,
  
"externalId": "string"
}

Responses​

TimeSheetDay found

application/json
JSON
{
  
"uuid": "string",
  
"userUuid": "string",
  
"day": "string",
  
"status": "string",
  
"note": "string",
  
"declinedNote": "string",
  
"startsAt": "string",
  
"endsAt": "string",
  
"breakTime": 0,
  
"duration": 0,
  
"startsAtManual": "string",
  
"endsAtManual": "string",
  
"breakTimeManual": 0,
  
"durationManual": 0,
  
"expectedDuration": 0,
  
"breakTimeErrorType": "string",
  
"breakTimeErrorExpected": 0,
  
"breakTimeErrorValue": 0,
  
"breakTimeErrorDurationMin": 0,
  
"durationErrorExpected": 0,
  
"durationErrorValue": 0,
  
"submittedAt": "string",
  
"submittedFirstAt": "string",
  
"approvedAt": "string",
  
"declinedAt": "string",
  
"manipulatedAt": "string",
  
"approvedByUuid": "string",
  
"declinedByUuid": "string",
  
"manipulatedByUuid": "string",
  
"externalId": "string",
  
"createdAt": "string",
  
"updatedAt": "string"
}

Playground​

Server
Authorization
Body

Samples​


Get a TimeSheetDay​

GET
/v2/time-sheet-days/{timeSheetDayUuid}

Get a TimeSheetDay by ID

Authorizations​

apiKey
Type
HTTP (bearer)

Parameters​

Path Parameters

timeSheetDayUuid*
Type
string
Required
Format
"uuid"

Responses​

TimeSheetDay found

application/json
JSON
{
  
"uuid": "string",
  
"userUuid": "string",
  
"day": "string",
  
"status": "string",
  
"note": "string",
  
"declinedNote": "string",
  
"startsAt": "string",
  
"endsAt": "string",
  
"breakTime": 0,
  
"duration": 0,
  
"startsAtManual": "string",
  
"endsAtManual": "string",
  
"breakTimeManual": 0,
  
"durationManual": 0,
  
"expectedDuration": 0,
  
"breakTimeErrorType": "string",
  
"breakTimeErrorExpected": 0,
  
"breakTimeErrorValue": 0,
  
"breakTimeErrorDurationMin": 0,
  
"durationErrorExpected": 0,
  
"durationErrorValue": 0,
  
"submittedAt": "string",
  
"submittedFirstAt": "string",
  
"approvedAt": "string",
  
"declinedAt": "string",
  
"manipulatedAt": "string",
  
"approvedByUuid": "string",
  
"declinedByUuid": "string",
  
"manipulatedByUuid": "string",
  
"externalId": "string",
  
"createdAt": "string",
  
"updatedAt": "string"
}

Playground​

Server
Authorization
Variables
Key
Value

Samples​


Update a TimeSheetDay​

PATCH
/v2/time-sheet-days/{timeSheetDayUuid}

Update a TimeSheetDay by ID

Authorizations​

apiKey
Type
HTTP (bearer)

Parameters​

Path Parameters

timeSheetDayUuid*
Type
string
Required
Format
"uuid"

Request Body​

application/json
JSON
{
  
"status": "string",
  
"note": "string",
  
"declinedNote": "string",
  
"startsAtManual": "string",
  
"endsAtManual": "string",
  
"breakTimeManual": 0,
  
"durationManual": 0,
  
"externalId": "string"
}

Responses​

TimeSheetDay found

application/json
JSON
{
  
"uuid": "string",
  
"userUuid": "string",
  
"day": "string",
  
"status": "string",
  
"note": "string",
  
"declinedNote": "string",
  
"startsAt": "string",
  
"endsAt": "string",
  
"breakTime": 0,
  
"duration": 0,
  
"startsAtManual": "string",
  
"endsAtManual": "string",
  
"breakTimeManual": 0,
  
"durationManual": 0,
  
"expectedDuration": 0,
  
"breakTimeErrorType": "string",
  
"breakTimeErrorExpected": 0,
  
"breakTimeErrorValue": 0,
  
"breakTimeErrorDurationMin": 0,
  
"durationErrorExpected": 0,
  
"durationErrorValue": 0,
  
"submittedAt": "string",
  
"submittedFirstAt": "string",
  
"approvedAt": "string",
  
"declinedAt": "string",
  
"manipulatedAt": "string",
  
"approvedByUuid": "string",
  
"declinedByUuid": "string",
  
"manipulatedByUuid": "string",
  
"externalId": "string",
  
"createdAt": "string",
  
"updatedAt": "string"
}

Playground​

Server
Authorization
Variables
Key
Value
Body

Samples​


Find or create a TimeSheetDay by user and day​

POST
/v2/time-sheet-days/by-user

Answers the TimeSheetDay of userUuid on day, creating it (with its week and month) if it does not exist yet. A day more than 3 calendar months ahead is rejected with 400.

Authorizations​

apiKey
Type
HTTP (bearer)

Request Body​

application/json
JSON
{
  
"userUuid": "string",
  
"day": "string"
}

Responses​

TimeSheetDay found

application/json
JSON
{
  
"uuid": "string",
  
"userUuid": "string",
  
"day": "string",
  
"status": "string",
  
"note": "string",
  
"declinedNote": "string",
  
"startsAt": "string",
  
"endsAt": "string",
  
"breakTime": 0,
  
"duration": 0,
  
"startsAtManual": "string",
  
"endsAtManual": "string",
  
"breakTimeManual": 0,
  
"durationManual": 0,
  
"expectedDuration": 0,
  
"breakTimeErrorType": "string",
  
"breakTimeErrorExpected": 0,
  
"breakTimeErrorValue": 0,
  
"breakTimeErrorDurationMin": 0,
  
"durationErrorExpected": 0,
  
"durationErrorValue": 0,
  
"submittedAt": "string",
  
"submittedFirstAt": "string",
  
"approvedAt": "string",
  
"declinedAt": "string",
  
"manipulatedAt": "string",
  
"approvedByUuid": "string",
  
"declinedByUuid": "string",
  
"manipulatedByUuid": "string",
  
"externalId": "string",
  
"createdAt": "string",
  
"updatedAt": "string"
}

Playground​

Server
Authorization
Body

Samples​