> For the complete documentation index, see [llms.txt](https://docs.snapfix.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.snapfix.com/how-the-apps-work/screens/planner/manage-planned-tasks.md).

# Manage planned tasks

{% hint style="info" %}
Draft, written by an agent and not yet checked by a person ([how to read these docs](https://docs.snapfix.com/how-to-read.md)). Platforms: web, iOS and Android. [Source on GitHub](https://github.com/snapfix/docs/blob/main/spec/screens/planner/manage-planned-tasks.md).
{% endhint %}

The list of schedules (the web also says "planners"): the repeating rules that create planned tasks. People select one, pause or resume it, or open it to change it.

![Manage planned tasks](https://3653879137-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsVVGa79QbcEkJ7n8srxe%2Fuploads%2Fgit-blob-e6a433cb58fcdf72f231b726603c5eb90fb04aa4%2Fmanage-planned-tasks.png?alt=media)

The picture shows the web planner's left column: the calendar, "Manage Planned Tasks" and schedule cards with their switches.

* **Where:** web `/plan/planner`, the "Manage Planned Tasks" column under the calendar on [Planned tasks](https://docs.snapfix.com/how-the-apps-work/screens/planner/planned-tasks.md). iOS and Android: [Plan](https://docs.snapfix.com/how-the-apps-work/screens/planner/plan.md) > the "Planned Tasks" chip tapped while the planned tasks show; the chip then reads "Scheduler". iOS also opens it from the settings icon on the planned tasks page. Inside a group the same list is on the [Group planner](https://docs.snapfix.com/how-the-apps-work/screens/planner/group-planner.md).
* **Who:** any signed-in user sees the list; it is not filtered by the caller's groups on the server. Who may pause, resume and open a schedule is in [Actions](#actions).
* **Feature:** [Planned tasks](https://docs.snapfix.com/product/features/planner/planned-tasks.md)

The occurrences these schedules create are [Planned tasks](https://docs.snapfix.com/how-the-apps-work/screens/planner/planned-tasks.md). Changing a schedule is [Create planned task](https://docs.snapfix.com/how-the-apps-work/screens/planner/planned-task.md).

## Layout

**Web**, the left column of [Planned tasks](https://docs.snapfix.com/how-the-apps-work/screens/planner/planned-tasks.md), 475 px wide:

1. "Manage Planned Tasks" with an info icon: "Manage all your planned tasks for this site." ("Manage all your planned tasks for this group." on a group).
2. One card per schedule, 10 per page, more as the column scrolls to the end. With "Select Planners" on, the right column goes away and the cards form a two-column grid, each with a checkbox.

Each card shows, top to bottom:

* "Ends on" with the date ("Ends on Nov 30, 2026"), "Ended on" once it has passed, or "Never ends"; the repeat: "Daily", "Weekly", "Monthly", "Yearly" or "Single"; and the pause switch, only for users who may change the schedule and only while it is still active (not past its end date, and for a single schedule not past its date).
* The picture, or the large text, with a red status dot and the priority when set. A paused schedule has a pause badge over the picture.
* Up to three assignee pictures, then "+N", or "Not Assigned".
* The title; then the room and the tags, two items in all, then "+N" for the tags past the second.
* The created date, the group's image and name, and a "⋯" button for users who may change the schedule.

**iOS**, the "Scheduler" page:

* The [Plan](https://docs.snapfix.com/how-the-apps-work/screens/planner/plan.md) chips, the first one reading "Scheduler". In a group, the group's name and address under a group icon.
* A search icon that opens the field "Search schedules".
* One row per schedule: the task row ([Group tasks](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md)) plus "Ends on" or "Ended on" with the date, or "Never ends"; the repeat type; the switch; and a settings button. Tapping the row does nothing.
* Pull to refresh; the next 10 load at the last row.

**Android**, the schedules view:

* The chip row, the first chip reading "Scheduler" with a dropdown mark, and a search icon that reveals the "Search" field. The heading "Manage Planned Tasks" and its info button are in the layout but hidden.
* One row per schedule: the picture or large text, the title, the group, the end date, the repeat type, the switch and the settings icon.
* Pull to refresh; the next 10 load on scroll.

## Inputs

| Field                   | Type     | Required | Default                   | Rules and messages                                                                                                                                                                                                                                                                           |
| ----------------------- | -------- | -------- | ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Search (web)            | text     | no       | empty                     | The page's "Search Planned Tasks" box, 1 s after typing stops. Only this list is searched, on the server; the planned tasks beside it stay as they were. Live, the search found a new planner by its title but returned nothing (`total_count: 0`) for four words shown on first-page cards. |
| Search (iOS)            | text     | no       | empty                     | "Search schedules", 1 s after typing stops, then the list reloads from the first page with `search`.                                                                                                                                                                                         |
| Search (Android)        | text     | no       | empty                     | Every change reloads the first page with the text, with no wait.                                                                                                                                                                                                                             |
| Selected schedule (web) | one card | no       | none                      | Selecting a card limits the planned tasks to that schedule; selecting it again clears the limit. A paused schedule cannot be selected: the click does nothing.                                                                                                                               |
| Switch                  | toggle   | no       | on for an active schedule | Off pauses, on resumes. Turning it off asks first ([Dialogs](#dialogs-and-sheets)); turning it on does not. Live, the web switch moves to off at once and the question appears about a second later; "Cancel" moves it back.                                                                 |

The filters of [Planned tasks](https://docs.snapfix.com/how-the-apps-work/screens/planner/planned-tasks.md#filters) also narrow the web list.

## Actions

| Action                              | Who                                                                                                                                                    | What happens                                                                                                                                                                                                                                                                                                                                                                               | API                                                                                                                                                                                                                                                                     |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Open the list                       | anyone                                                                                                                                                 | Loads the first 10. Web sends the site, the group filter (or the one group) and the search. iOS sends the site and the user's groups of the site (not inactive groups or asset registers), or the one group. Android sends the site and every group of the site the user belongs to, or the one group.                                                                                     | Web: [`POST /schedules-v2`](https://docs.snapfix.com/engineering-reference/api/planner.md#post-schedules-v2) with `offset` and `limit` in the query. iOS and Android: [`POST /schedules`](https://docs.snapfix.com/engineering-reference/api/planner.md#post-schedules) |
| Scroll to the end                   | anyone                                                                                                                                                 | Loads the next 10.                                                                                                                                                                                                                                                                                                                                                                         | As above                                                                                                                                                                                                                                                                |
| Select a card (web)                 | anyone                                                                                                                                                 | Reloads the planned tasks for that schedule, from the selected day.                                                                                                                                                                                                                                                                                                                        | [`POST /v4/jobs`](https://docs.snapfix.com/engineering-reference/api/planner.md#post-v4jobs) with `schedule_uuids`                                                                                                                                                      |
| Turn the switch off (pause)         | web: see the note below; iOS: group admin, or both create permissions; Android: not read-only, and both create permissions or admin                    | Asks "Deactivate Schedule"; "Deactivate" pauses, "Cancel" puts the switch back. A paused card gets the pause badge, and on the web the planned tasks reload.                                                                                                                                                                                                                               | [`PUT /schedule/{uuid}/pause`](https://docs.snapfix.com/engineering-reference/api/planner.md#put-scheduleuuidpause)                                                                                                                                                     |
| Turn the switch on (resume)         | same                                                                                                                                                   | Resumes at once. Occurrences come back once the server has rebuilt them, so the planned tasks can lag behind the switch for a while (how long was not measured). The next date is worked out again from today, so no tasks are created for the paused days \[[ASK-60](https://github.com/snapfix/docs/blob/main/ASK.md#ask-60-should-resuming-a-paused-planner-catch-up-on-missed-tasks)]. | [`PUT /schedule/{uuid}/play`](https://docs.snapfix.com/engineering-reference/api/planner.md#put-scheduleuuidplay)                                                                                                                                                       |
| "⋯" (web), settings (iOS, Android)  | same                                                                                                                                                   | Web: checks the group, then opens [Create planned task](https://docs.snapfix.com/how-the-apps-work/screens/planner/planned-task.md) at `/plan/planned-task/edit/:id/settings`, or shows the permission alert. iOS and Android open the same form for the whole schedule.                                                                                                                   | Web: [`GET /v1/app/businesses/{uuid}`](https://docs.snapfix.com/engineering-reference/api/groups.md), then [`GET /v3/schedule/{uuid}`](https://docs.snapfix.com/engineering-reference/api/planner.md#get-v3scheduleuuid)                                                |
| "Actions" > "Select Planners" (web) | users who see "Add Task"                                                                                                                               | Opens the selection bar ([Dialogs](#dialogs-and-sheets)). "Deactivate Planners" asks the same "Deactivate Schedule" question, then pauses every ticked schedule in the background and reloads the list. The reload comes before the server has done the work, so a card can still look active.                                                                                             | [`POST /schedules/pause`](https://docs.snapfix.com/engineering-reference/api/planner.md#post-schedulespause)                                                                                                                                                            |
| Create                              | web: the empty list's "+"; iOS: "Create Planned Tasks" in the empty state; Android: "Create new planned task" in the empty state, or the top bar's "+" | Opens [Create planned task](https://docs.snapfix.com/how-the-apps-work/screens/planner/planned-task.md).                                                                                                                                                                                                                                                                                   | -                                                                                                                                                                                                                                                                       |
| Pull to refresh (iOS, Android)      | anyone                                                                                                                                                 | Reloads from the first page.                                                                                                                                                                                                                                                                                                                                                               | [`POST /schedules`](https://docs.snapfix.com/engineering-reference/api/planner.md#post-schedules)                                                                                                                                                                       |

**Who may change a schedule on the web.** In a group, the switch and "⋯" show only with both create permissions. On the site's page they show to every user who is not inactive in the schedule's group. Each switch or "⋯" press then checks the group again and needs "Create Planned Tasks" or group admin; without it the alert shows and the switch returns. The apps hide both controls instead. The server routes check only that the caller is signed in.

**Mobile results.** A failed pause or resume shows the server's message in a toast and puts the switch back. "schedule already paused!" and "schedule is already active!" count as success and the row takes that state. Android with no connection shows "You must be connected to the Internet to carry out this task. Please connect and try again." and puts the switch back.

## States

* **Loading:** web: six skeleton cards, then a spinner at the bottom while the next page loads. iOS: the refresh spinner, "Refreshing...". Android: the refresh spinner; with no connection it never stops.
* **Empty:** web: a calendar picture, "Manage your Planned Tasks in a Snap!" and "To create your first "Planned Task", click the + button.", where the "+" is a picture that opens the create page. iOS: "Keep it up with your recurring tasks", "Start creating your planned tasks now." and "Create Planned Tasks". Android: "Manage your Planned Tasks in a Snap!", "To create your first 'Planned Task', tap the button below." and "Create new planned task".
* **Error:** web: a failed first load shows the empty state with no message. iOS: a failed load counts as the end of the list, so with nothing loaded it shows the empty state. Android: a failed load (other than an expired session, which refreshes the token and retries) posts an empty page, so a first load shows the empty state.
* **No permission:** the list still loads. The controls follow the rules in [Actions](#actions).
* **Offline (mobile):** neither app keeps schedules on the device. iOS shows what is already loaded, or the empty state. Android: see Loading.

## Dialogs and sheets

* **Deactivate Schedule** (all platforms): title "Deactivate Schedule"; text "Do you want to deactivate this schedule of Planned Tasks?" and "Note: you can reactivate it any time."; buttons "Deactivate" and cancel. The web uses an alert, Android a bottom sheet with "Cancel", iOS a confirmation sheet whose text reads "…Planned Tasks ?". The bulk version names no schedules and no count.
* **Selection bar** (web): replaces the page's title row with "Select Loaded Planners", "N Planner(s) Selected", "Deactivate Planners" (off while nothing is ticked) and a close button. "Select Loaded Planners" ticks every schedule loaded so far, not every match. Closing leaves the mode. On success the notice reads "This action is running in the background. Changes may take some time to reflect on related planners once processing completes."
* **No permission** (web): "You don't have the right permissions to create or edit planned tasks in this group. Reach out to the group admin to review your permissions." A failed group check shows "Something went wrong".

## Platform differences

| Topic                                            | Web                                                                                                     | iOS                                                                                               | Android                                                                                           |
| ------------------------------------------------ | ------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| Where                                            | beside the calendar, always visible                                                                     | second page of the Plan pager                                                                     | separate view of the Plan tab                                                                     |
| List API                                         | [`POST /schedules-v2`](https://docs.snapfix.com/engineering-reference/api/planner.md#post-schedules-v2) | [`POST /schedules`](https://docs.snapfix.com/engineering-reference/api/planner.md#post-schedules) | [`POST /schedules`](https://docs.snapfix.com/engineering-reference/api/planner.md#post-schedules) |
| Search                                           | shared box, 1 s                                                                                         | "Search schedules", 1 s                                                                           | every change                                                                                      |
| Selecting a schedule                             | filters the planned tasks                                                                               | does nothing                                                                                      | does nothing                                                                                      |
| Controls for users who may not change a schedule | shown on the site's page, then refused                                                                  | hidden                                                                                            | hidden                                                                                            |
| Finished schedule                                | no switch                                                                                               | no switch                                                                                         | no switch                                                                                         |
| Bulk pause                                       | "Select Planners"                                                                                       | no                                                                                                | no                                                                                                |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.snapfix.com/how-the-apps-work/screens/planner/manage-planned-tasks.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
