---
title: Workstation/Person exceptions
description: "Here you will learn how to create, update and delete workstation and person exceptions. Exceptions are breaks in a workstation's capacities or person's shifts. A machine exception can be for example a service or maintenance break and a person exception…"
url: "https://skyplanner.ai/docs/workstation-person-exceptions/"
updated: "2025-05-02"
category: Integrations
tags:
  - API
  - Integration
---

# Workstation/Person exceptions

Here you will learn how to create, update and delete workstation and person exceptions. Exceptions are breaks in a workstation's capacities or person's shifts. A machine exception can be for example a service or maintenance break and a person exception a holiday, sick leave or a vacation.

#### Workstation exceptions

Workstation exceptions can be accessed from the /workstation-exceptions endpoint.

Person exceptions can be accessed from the /person-exceptions endpoint.

#### Fetching exceptions

You fetch existing exceptions by sending GET-requests like this:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-2.png)
**Fig 1.** Fetching a person's exceptions

You can fetch workstation exceptions by **type**, **workstation_id**, **external_id** or **modified** conditions.

You can fetch person exceptions by **type**, **person_id** or **modified** conditions

#### Creating an exception

You can create a workstation exception by sending a POST request like this:

![](https://skyplanner.ai/wp-content/uploads/2025/04/image-5.png)
**Fig 2.** Creating a workstation exception

To specify which workstation the exception is scheduled to you use the **workstation_id** field.

The allowed **types** of exceptions for workstations are: **Maintenance**, **Cleaning** and**Move/Organize**.

Note that you can also give an **external_id** for a workstation exception.

To create a person exception send a POST request like this:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image.png)
**Fig 3.** Creating a person exception

To specify which person the exception is created for you need to use the **person_id**.

The allowed **types** of exceptions for people are: **Holiday, Sick Leave, Flexi Leave, Unpaid Leave**.

#### Updating an exception

To update an exception you need to use the **exception id** you can get by sending GET-requests or from the response message when creating said exception.

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-1.png)
**Fig 4.** Updating an exception

#### Deleting exceptions

Deleting workstation exceptions can be done by providing **internal exception ids**, **external_ids**or**workstation_ids**.

Deleting person exceptions can be done by providing **internal exception ids** or **person_ids**.

Multiple sets of exceptions can be deleted in a single request by giving the ids in an array:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-4.png)
**Fig 5.** Deleting workstation exceptions

The response message from a DELETE-request will tell you how many exceptions have been deleted.
