# Calendar

## In Octoo

The calendar is available at [app.octoo.com/calendar](https://app.octoo.com/calendar). It displays a provider's jobs and opportunities in one place for a complete view of their schedule. Partners can also view a provider's calendar from the provider's profile.

<figure><img src="/files/u1ZJboHYfLRBV6E88eBz" alt="Calendar week view showing jobs and opportunities with color-coded events and sidebar filters"><figcaption><p>The calendar in week view with the sidebar expanded, showing job and opportunity filters with a color legend.</p></figcaption></figure>

### Views

Switch between three views using the buttons in the top-right corner of the calendar:

* **Day** — Shows a single day with hourly time slots. Use the arrow buttons to move to the previous or next day.
* **Week** — Shows a full week (Sunday through Saturday) with hourly time slots. This is the default view.
* **Month** — Shows a traditional monthly calendar with events listed on each day.

Use the **today** button to jump back to the current date, or the **refresh** button to reload the calendar with the latest data.

### Events

Jobs and opportunities appear as color-coded blocks on the calendar. The color legend is shown in the sidebar next to each filter:

* **Green** — Assigned jobs that have been awarded to the provider.
* **Yellow-green** — Contingent jobs where the provider is provisionally assigned but not yet confirmed.
* **Orange** — Pending jobs that are awaiting confirmation.
* **Pink** — Opportunities that are available for the provider to accept or decline.
* **Gray** — Availability blocks showing times the provider has marked as unavailable.

Each event displays the time range and the request name. Click on any event to see a detail popup with:

* **Job status** — Whether the job is Awarded, Contingent, or Pending, with a link to the job record.
* **Customer** — The customer organization for the request.
* **Date and time** — The scheduled time in the selected timezone, with a link to the service.
* **Request** — The request name, service type (e.g., Workplace - Meeting - Small group), and a link to the request.
* **Location** — Whether the job is remote or on-site, and the city.
* **Team members** — Other providers assigned to the same service, including their role and language pair.

### Sidebar filters

Expand the sidebar using the menu icon to access filters and settings:

#### Jobs filters

Toggle which [Jobs](/providers/jobs.md) types appear on the calendar:

* **Assigned** — Jobs that have been awarded to the provider.
* **Contingent** — Jobs where the provider is provisionally assigned but not yet confirmed.
* **Pending** — Jobs that are awaiting confirmation.

Use **Deselect all** to hide all jobs at once, then toggle on only the types needed.

#### Opportunities filters

* [Opportunities](/providers/opportunities.md) — Show or hide available opportunities on the calendar.
* **Hide declined opportunities** — When enabled, opportunities the provider has already declined will not appear.

#### Settings

Select a **Timezone** to display all calendar events in a preferred timezone. This is useful for providers who work across multiple time zones.

## Subscribe on a phone or computer

Providers can subscribe to their Octoo calendar on their phone, tablet, or computer to integrate their schedule directly with their preferred calendar device. See [Subscribe](/providers/calendar/subscribe.md)for more information.


---

# 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://docs.octoo.com/providers/calendar.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.
