# Appointment Breaks

## How do I record an Appointment Break?

To begin recording an Appointment Break, simply open an [Appointment](/maica-knowledge-base/getting-started/maica-key-concepts/appointment.md) and then click the `Manage Appointment Breaks` button at the bottom of the screen to bring up the dialogue box.&#x20;

<figure><img src="/files/31aVIgmwqdlnEktF3hKr" alt=""><figcaption></figcaption></figure>

Once selected, you can create a new break by selecting the `+ New` button on the right hand side of the screen, as shown below.&#x20;

<figure><img src="/files/Ic3HIL9PqzAfgeMmVHr7" alt=""><figcaption></figcaption></figure>

Once you have added a new Appointment Break, you will be prompted to populate a number of fields detailing the break. Here, you can assign the relevant Date & Time information, the relevant Resource(s), the break category and write custom notes.&#x20;

{% hint style="info" %}
In order to maintain the parameters of an Appointment, **Maica** will not allow you to create an Appointment Break outside the `Date` or `Time` of the Scheduled Appointment. You also must assign a `Category` in order to submit a Note.&#x20;
{% endhint %}

## Appointment Break Actions

### 1. Create Corresponding Timesheet&#x20;

Within an Appointment Break, you can choose to create a corresponding [Timesheet](/maica-knowledge-base/getting-started/maica-key-concepts/timesheet.md). You do so by simply clicking the toggle, as shown below.&#x20;

<figure><img src="/files/l3uhkVJSWzyf3kYbqHZN" alt=""><figcaption></figcaption></figure>

If the [Timesheet](/maica-knowledge-base/getting-started/maica-key-concepts/timesheet.md) is created, it must be assigned a Timesheet Activity.&#x20;

{% hint style="info" %}
The Break will be stored as an Unavailability record against the allocated Resource.&#x20;
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://knowledge.maica.com.au/maica-knowledge-base/appointments/appointment-actions/appointment-breaks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
