TimeSheetDay

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

Operations

GET/v1/time-sheet-days/specGET/v1/time-sheet-daysPOST/v1/time-sheet-daysGET/v1/time-sheet-days/{timeSheetDayId}PATCH/v1/time-sheet-days/{timeSheetDayId}GET/v1/time-sheet-days/by-user

---

OpenAPI Spec

GET

/v1/time-sheet-days/spec

Get OpenAPI 3.1.0 spec for TimeSheetDay API

Responses

Returns OpenAPI 3.1.0 spec for TimeSheetDay API

Content-Type

application/json

{

}

GET

/v1/time-sheet-days/spec

Playground

Samples

---

List TimeSheetDays

GET

/v1/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

id

userId

day

status

submittedAt

approvedAt

externalId

createdAt

updatedAt

Responses

List response

Content-Type

application/json

{

"page": 0,

"pages": 0,

"size": 10,

"items": [

{

"id": 0,

"userId": 0,

"day": "string",

"status": "string",

"note": "string",

"declinedNote": "string",

"startsAt": "string",

"endsAt": "string",

"breakTime": 0,

"duration": 0,

"expectedDuration": 0,

"breakTimeErrorType": "string",

"breakTimeErrorExpected": 0,

"breakTimeErrorValue": 0,

"breakTimeErrorDurationMin": 0,

"durationErrorExpected": 0,

"durationErrorValue": 0,

"submittedAt": "string",

"submittedFirstAt": "string",

"approvedAt": "string",

"approvedById": 0,

"declinedAt": "string",

"declinedById": 0,

"manipulatedAt": "string",

"manipulatedById": 0,

"externalId": "string",

"createdAt": "string",

"updatedAt": "string"

}

]

}

GET

/v1/time-sheet-days

Playground

Server

Authorization

apiKey

Variables

Key

Value

page

size

id

userId

day

status

submittedAt

approvedAt

externalId

createdAt

updatedAt

Samples

---

Create a new TimeSheetDay

POST

/v1/time-sheet-days

Create a new TimeSheetDay

Authorizations

apiKey

Type

HTTP (bearer)

Request Body

application/json

{

"userId": 0,

"day": "string",

"status": "string",

"note": "string",

"declinedNote": "string",

"startsAt": "string",

"endsAt": "string",

"breakTime": 0,

"duration": 0,

"externalId": "string"

}

Responses

TimeSheetDay found

Content-Type

application/json

{

"id": 0,

"userId": 0,

"day": "string",

"status": "string",

"note": "string",

"declinedNote": "string",

"startsAt": "string",

"endsAt": "string",

"breakTime": 0,

"duration": 0,

"expectedDuration": 0,

"breakTimeErrorType": "string",

"breakTimeErrorExpected": 0,

"breakTimeErrorValue": 0,

"breakTimeErrorDurationMin": 0,

"durationErrorExpected": 0,

"durationErrorValue": 0,

"submittedAt": "string",

"submittedFirstAt": "string",

"approvedAt": "string",

"approvedById": 0,

"declinedAt": "string",

"declinedById": 0,

"manipulatedAt": "string",

"manipulatedById": 0,

"externalId": "string",

"createdAt": "string",

"updatedAt": "string"

}

POST

/v1/time-sheet-days

Playground

Server

Authorization

apiKey

Body

Samples

---

Get a TimeSheetDay

GET

/v1/time-sheet-days/{timeSheetDayId}

Get a TimeSheetDay by ID

Authorizations

apiKey

Type

HTTP (bearer)

Parameters

Path Parameters

timeSheetDayId*

Type

integer

Required

Format

"int32"

Responses

TimeSheetDay found

Content-Type

application/json

{

"id": 0,

"userId": 0,

"day": "string",

"status": "string",

"note": "string",

"declinedNote": "string",

"startsAt": "string",

"endsAt": "string",

"breakTime": 0,

"duration": 0,

"expectedDuration": 0,

"breakTimeErrorType": "string",

"breakTimeErrorExpected": 0,

"breakTimeErrorValue": 0,

"breakTimeErrorDurationMin": 0,

"durationErrorExpected": 0,

"durationErrorValue": 0,

"submittedAt": "string",

"submittedFirstAt": "string",

"approvedAt": "string",

"approvedById": 0,

"declinedAt": "string",

"declinedById": 0,

"manipulatedAt": "string",

"manipulatedById": 0,

"externalId": "string",

"createdAt": "string",

"updatedAt": "string"

}

GET

/v1/time-sheet-days/{timeSheetDayId}

Playground

Server

Authorization

apiKey

Variables

Key

Value

timeSheetDayId*

Samples

---

Update a TimeSheetDay

PATCH

/v1/time-sheet-days/{timeSheetDayId}

Update a TimeSheetDay by ID

Authorizations

apiKey

Type

HTTP (bearer)

Parameters

Path Parameters

timeSheetDayId*

Type

integer

Required

Format

"int32"

Request Body

application/json

{

"status": "string",

"note": "string",

"declinedNote": "string",

"startsAt": "string",

"endsAt": "string",

"breakTime": 0,

"duration": 0,

"externalId": "string"

}

Responses

TimeSheetDay found

Content-Type

application/json

{

"id": 0,

"userId": 0,

"day": "string",

"status": "string",

"note": "string",

"declinedNote": "string",

"startsAt": "string",

"endsAt": "string",

"breakTime": 0,

"duration": 0,

"expectedDuration": 0,

"breakTimeErrorType": "string",

"breakTimeErrorExpected": 0,

"breakTimeErrorValue": 0,

"breakTimeErrorDurationMin": 0,

"durationErrorExpected": 0,

"durationErrorValue": 0,

"submittedAt": "string",

"submittedFirstAt": "string",

"approvedAt": "string",

"approvedById": 0,

"declinedAt": "string",

"declinedById": 0,

"manipulatedAt": "string",

"manipulatedById": 0,

"externalId": "string",

"createdAt": "string",

"updatedAt": "string"

}

PATCH

/v1/time-sheet-days/{timeSheetDayId}

Playground

Server

Authorization

apiKey

Variables

Key

Value

timeSheetDayId*

Body

Samples

---

Get a TimeSheetDay by user and day

GET

/v1/time-sheet-days/by-user

Look up a single TimeSheetDay by userId and day. The row is created on demand if it does not yet exist (parent week and month are auto-resolved). Requests for a day more than 3 calendar months in the future are rejected with 400.

Authorizations

apiKey

Type

HTTP (bearer)

Parameters

Query Parameters

userId*

Type

integer

Required

day*

Type

string

Required

Format

"date"

Responses

TimeSheetDay found

Content-Type

application/json

{

"id": 0,

"userId": 0,

"day": "string",

"status": "string",

"note": "string",

"declinedNote": "string",

"startsAt": "string",

"endsAt": "string",

"breakTime": 0,

"duration": 0,

"expectedDuration": 0,

"breakTimeErrorType": "string",

"breakTimeErrorExpected": 0,

"breakTimeErrorValue": 0,

"breakTimeErrorDurationMin": 0,

"durationErrorExpected": 0,

"durationErrorValue": 0,

"submittedAt": "string",

"submittedFirstAt": "string",

"approvedAt": "string",

"approvedById": 0,

"declinedAt": "string",

"declinedById": 0,

"manipulatedAt": "string",

"manipulatedById": 0,

"externalId": "string",

"createdAt": "string",

"updatedAt": "string"

}

GET

/v1/time-sheet-days/by-user

Playground

Server

Authorization

apiKey

Variables

Key

Value

userId*

day*

Samples

---