ETO (Everyone time-off)

This documentation is for LiquidPlanner New:

Use this endpoint to manage Everyone Time Off events in the workspace. id/time-off/eto/v1

Supported Methods


Add a new Everyone Time Off (ETO) event to block scheduling for everyone in the workspace on the provided Start and End dates.

Example: The example below adds a new ETO event called “Company Holiday” scheduled on 15th March 2023.

curl --location --request POST '<workspace id>/time-off/eto/v1' \
--header 'Authorization: Bearer <API Token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "description": "Company Holiday",
    "startDate": "2023-03-15",
    "endDate": "2023-03-15"


Send a PUT request to make changes to an existing ETO event.

Example: The example below can be used to rename an existing ETO event in the workspace.

curl --location --request PUT '<workspace id>/time-off/eto/v1/<ETO id>' \
--header 'Authorization: Bearer <API Token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "description": "Company Retreat Holiday"


Pull a list of all the ETO events from your workspace in a JSON format.

Sample Response

    "recordLimit": 500,
    "recordCount": 1,
    "data": [
            "id": 2265,
            "startDate": "2023-03-15",
            "endDate": "2023-03-16",
            "description": "Company Retreat Holiday",
            "createdAt": "2022-10-10T20:11:46.582528Z",
            "updatedAt": "2022-10-10T20:11:46.582Z",
            "createdById": 197,
            "updatedById": 213,
            "workspaceId": 21,
            "organizationId": 21

Filter Options

Apply the filter string to the endpoint URL.

Filter attributeField typeDescriptionFilter string
startDatedatePull a list of ETO events based on their start date?startDate[after]="2023-12-31"
endDatedatePull a list of ETO events based on their end date?endDate[before]="2024-01-01"