Home Features Pricing
Case studies Blog Support Contact us Refer a Business
Call us today on +44 (0)1227 812932 Get your FREE Trial

Controller : Work

DEPRECATED: NO

create retrieve retrieve update del Return to API overview

Calls: {root}/{version}/work


POST/v4/create
Route {root}/v4/work/create
Request type BODY
User level SUPER USER
Requires authentication Yes
Response type Single

Parameters

Name Type Nullable? Required? Min. Max. Nest Custom
user_id [INT32] REQUIRED 0 2147483647 - -
start_date DATE REQUIRED - -
monday MINUTE(INT32) REQUIRED 0 1440 - -
tuesday MINUTE(INT32) REQUIRED 0 1440 - -
wednesday MINUTE(INT32) REQUIRED 0 1440 - -
thursday MINUTE(INT32) REQUIRED 0 1440 - -
friday MINUTE(INT32) REQUIRED 0 1440 - -
saturday MINUTE(INT32) REQUIRED 0 1440 - -
sunday MINUTE(INT32) REQUIRED 0 1440 - -
allowance_type_id CUSTOM REQUIRED 0 1 - days (0)
hours (1)
monday_label [BYTE] ✓ OPTIONAL 0 255 - -
tuesday_label [BYTE] ✓ OPTIONAL 0 255 - -
wednesday_label [BYTE] ✓ OPTIONAL 0 255 - -
thursday_label [BYTE] ✓ OPTIONAL 0 255 - -
friday_label [BYTE] ✓ OPTIONAL 0 255 - -
saturday_label [BYTE] ✓ OPTIONAL 0 255 - -
sunday_label [BYTE] ✓ OPTIONAL 0 255 - -

Sample cURL

curl --location --request POST "{{ROOT}}/v4/work/create/" \
-H "Authorization: Bearer {{BEARER_TOKEN}}" \
-H "app-id:{{APP_ID}}" \
-H "Content-Type: application/json" \
-H "Accept-Encoding: gzip" \
-H "accept: */*" \
--data '{"user_id": "123456","allowance_type_id": "0"}'

Sample response

[
    {
      "object_name":"work_id",
      "type":"Int32",
      "is_nullable":false,
      "nest":null,
      "custom":null
      "note": 
  }
]
POST/v4/retrieve
Route {root}/v4/work/retrieve
Request type BODY
User level STAFF
Requires authentication Yes
Response type Array()

Parameters

Name Type Nullable? Required? Min. Max. Nest Custom
user_id [INT32] REQUIRED 0 2147483647 - -
start_date DATE OPTIONAL - -
end_date DATE OPTIONAL - -

Sample cURL

curl --location --request POST "{{ROOT}}/v4/work/retrieve/" \
-H "Authorization: Bearer {{BEARER_TOKEN}}" \
-H "app-id:{{APP_ID}}" \
-H "Content-Type: application/json" \
-H "Accept-Encoding: gzip" \
-H "accept: */*" \
--data '{"user_id": "123456"}'

Sample response

[
    {
      "object_name":"work_id",
      "type":"Int32",
      "is_nullable":false,
      "nest":null,
      "custom":null
      "note": 
  },
    {
      "object_name":"allowance_type_id",
      "type":"custom",
      "is_nullable":false,
      "nest":null,
      "custom":[
            {
                "name":"days",
                "value":"0"
            },
            {
                "name":"hours",
                "value":"1"
            }]
      "note": 
  },
    {
      "object_name":"start_date",
      "type":"Date",
      "is_nullable":false,
      "nest":null,
      "custom":null
      "note": 
  },
    {
      "object_name":"end_date",
      "type":"Date",
      "is_nullable":false,
      "nest":null,
      "custom":null
      "note": 
  },
    {
      "object_name":"monday",
      "type":"minute(int32)",
      "is_nullable":false,
      "nest":null,
      "custom":null
      "note": 
  },
    {
      "object_name":"tuesday",
      "type":"minute(int32)",
      "is_nullable":false,
      "nest":null,
      "custom":null
      "note": 
  },
    {
      "object_name":"wednesday",
      "type":"minute(int32)",
      "is_nullable":false,
      "nest":null,
      "custom":null
      "note": 
  },
    {
      "object_name":"thursday",
      "type":"minute(int32)",
      "is_nullable":false,
      "nest":null,
      "custom":null
      "note": 
  },
    {
      "object_name":"friday",
      "type":"minute(int32)",
      "is_nullable":false,
      "nest":null,
      "custom":null
      "note": 
  },
    {
      "object_name":"saturday",
      "type":"minute(int32)",
      "is_nullable":false,
      "nest":null,
      "custom":null
      "note": 
  },
    {
      "object_name":"sunday",
      "type":"minute(int32)",
      "is_nullable":false,
      "nest":null,
      "custom":null
      "note": 
  }
]
POST/v4.1/retrieve
Route {root}/v4.1/work/retrieve
Request type BODY
User level STAFF
Requires authentication Yes
Response type Array()

Parameters

Name Type Nullable? Required? Min. Max. Nest Custom
user_id [INT32] REQUIRED 0 2147483647 - -
start_date DATE OPTIONAL - -
end_date DATE OPTIONAL - -

Sample cURL

curl --location --request POST "{{ROOT}}/v4.1/work/retrieve/" \
-H "Authorization: Bearer {{BEARER_TOKEN}}" \
-H "app-id:{{APP_ID}}" \
-H "Content-Type: application/json" \
-H "Accept-Encoding: gzip" \
-H "accept: */*" \
--data '{"user_id": "123456"}'

Sample response

[
    {
      "object_name":"monday_label",
      "type":"Byte",
      "is_nullable":false,
      "nest":null,
      "custom":null
      "note": 
  },
    {
      "object_name":"tuesday_label",
      "type":"Byte",
      "is_nullable":false,
      "nest":null,
      "custom":null
      "note": 
  },
    {
      "object_name":"wednesday_label",
      "type":"Byte",
      "is_nullable":false,
      "nest":null,
      "custom":null
      "note": 
  },
    {
      "object_name":"thursday_label",
      "type":"Byte",
      "is_nullable":false,
      "nest":null,
      "custom":null
      "note": 
  },
    {
      "object_name":"friday_label",
      "type":"Byte",
      "is_nullable":false,
      "nest":null,
      "custom":null
      "note": 
  },
    {
      "object_name":"saturday_label",
      "type":"Byte",
      "is_nullable":false,
      "nest":null,
      "custom":null
      "note": 
  },
    {
      "object_name":"sunday_label",
      "type":"Byte",
      "is_nullable":false,
      "nest":null,
      "custom":null
      "note": 
  },
    {
      "object_name":"work_id",
      "type":"Int32",
      "is_nullable":false,
      "nest":null,
      "custom":null
      "note": 
  },
    {
      "object_name":"allowance_type_id",
      "type":"custom",
      "is_nullable":false,
      "nest":null,
      "custom":[
            {
                "name":"days",
                "value":"0"
            },
            {
                "name":"hours",
                "value":"1"
            }]
      "note": 
  },
    {
      "object_name":"start_date",
      "type":"Date",
      "is_nullable":false,
      "nest":null,
      "custom":null
      "note": 
  },
    {
      "object_name":"end_date",
      "type":"Date",
      "is_nullable":false,
      "nest":null,
      "custom":null
      "note": 
  },
    {
      "object_name":"monday",
      "type":"minute(int32)",
      "is_nullable":false,
      "nest":null,
      "custom":null
      "note": 
  },
    {
      "object_name":"tuesday",
      "type":"minute(int32)",
      "is_nullable":false,
      "nest":null,
      "custom":null
      "note": 
  },
    {
      "object_name":"wednesday",
      "type":"minute(int32)",
      "is_nullable":false,
      "nest":null,
      "custom":null
      "note": 
  },
    {
      "object_name":"thursday",
      "type":"minute(int32)",
      "is_nullable":false,
      "nest":null,
      "custom":null
      "note": 
  },
    {
      "object_name":"friday",
      "type":"minute(int32)",
      "is_nullable":false,
      "nest":null,
      "custom":null
      "note": 
  },
    {
      "object_name":"saturday",
      "type":"minute(int32)",
      "is_nullable":false,
      "nest":null,
      "custom":null
      "note": 
  },
    {
      "object_name":"sunday",
      "type":"minute(int32)",
      "is_nullable":false,
      "nest":null,
      "custom":null
      "note": 
  }
]
PUT/v4/update
Route {root}/v4/work/update
Request type BODY
User level SUPER USER
Requires authentication Yes
Response type Single

Parameters

Name Type Nullable? Required? Min. Max. Nest Custom
work_id [INT32] REQUIRED -2147483648 2147483647 - -
user_id [INT32] ✓ OPTIONAL 0 2147483647 - -
start_date DATE OPTIONAL - -
monday MINUTE(INT32) ✓ OPTIONAL 0 1440 - -
tuesday MINUTE(INT32) ✓ OPTIONAL 0 1440 - -
wednesday MINUTE(INT32) ✓ OPTIONAL 0 1440 - -
thursday MINUTE(INT32) ✓ OPTIONAL 0 1440 - -
friday MINUTE(INT32) ✓ OPTIONAL 0 1440 - -
saturday MINUTE(INT32) ✓ OPTIONAL 0 1440 - -
sunday MINUTE(INT32) ✓ OPTIONAL 0 1440 - -
allowance_type_id CUSTOM ✓ OPTIONAL - days (0)
hours (1)
monday_label [BYTE] ✓ OPTIONAL 0 255 - -
tuesday_label [BYTE] ✓ OPTIONAL 0 255 - -
wednesday_label [BYTE] ✓ OPTIONAL 0 255 - -
thursday_label [BYTE] ✓ OPTIONAL 0 255 - -
friday_label [BYTE] ✓ OPTIONAL 0 255 - -
saturday_label [BYTE] ✓ OPTIONAL 0 255 - -
sunday_label [BYTE] ✓ OPTIONAL 0 255 - -

Sample cURL

curl --location --request PUT "{{ROOT}}/v4/work/update/" \
-H "Authorization: Bearer {{BEARER_TOKEN}}" \
-H "app-id:{{APP_ID}}" \
-H "Content-Type: application/json" \
-H "Accept-Encoding: gzip" \
-H "accept: */*" \
--data '{"work_id": "123456","user_id": "123456","allowance_type_id": "0"}'

Sample response

[
    {
      "object_name":"work_id",
      "type":"Int32",
      "is_nullable":false,
      "nest":null,
      "custom":null
      "note": 
  }
]
DELETE/v4/del
Route {root}/v4/work/del
Request type URL
User level SUPER USER
Requires authentication Yes
Response type Single
Sample call{root}/v0/work/del/12345678

Parameters

Name Type Nullable? Required? Min. Max. Nest Custom
work_id INT32 REQUIRED 0 2147483647 - -

Sample cURL

curl --location --request DELETE "{{ROOT}}/v4/work/del/12345678-H "Authorization: Bearer {{BEARER_TOKEN}}" \
-H "app-id:{{APP_ID}}" \
-H "Content-Type: application/json" \
-H "Accept-Encoding: gzip" \
-H "accept: */*" \

Sample response

Standard response object returned, see API Overview for structure.


Don't have a WhosOff account yet?

Instantly reduce time spent on leave management with your FREE, no obligation trial today!
Sign up today and get until Monday, 26th January 2026 to try the full service, for Free!

Get your instant FREE account today
Close [X]
Schedule your personalised demo

Let us show you, in 20 minutes, how WhosOff can elevate your leave management process.

Simply enter your email address in the space provided below and one of our team will reach out and setup a personalised platform demonstration.


Book your demonstration now

Manage Cookie Consent

Cookies are used to store and/or access device information. Providing consent to these technologies allows us to process data such as browsing behaviour. Not consenting or removing consent may adversely affect some features and functions.

AdvertisingEnables storage related to advertising, for example, advertising campaign.
AnalyticsEnables storage related to analytics, for example, visit duration.
TargetingSets consent for sending user data to Google for online advertising purposes.
MarketingSets consent for personalized advertising.
Cookie Policy
Manage cookies