# How do I stop a recurring task?

Company: Socra — Multiply Your Judgment
Canonical URL: https://support.socra.com/articles/art_01m46eky7fqae7pvdxr3qzcc2s-stop-recurring

Complete or cancel the task to end its recurring series. Use pause if you intend to keep the series for later. Completing only one occurrence leaves a recurring task active.

These commands require Task CLI 0.1.2 or later. Run `socra update` if your installed plugin predates that release.

To mark the whole task finished, replace `TASK_ID` with its ID:

```sh
socra task complete TASK_ID
```

If you are stopping it without marking the work complete, use:

```sh
socra task cancel TASK_ID
```

Both actions clear the next run, pause the saved schedule, and cancel pending occurrences. Check the returned status to confirm the change. An action that is already executing cannot be undone by changing the task's status.

To restart a completed or canceled task, reopen it first:

```sh
socra task reopen TASK_ID
```

Reopening returns the task to pending but leaves its schedule paused. Review the instructions and timing before resuming:

```sh
socra task resume TASK_ID
```

A one-time schedule in the past cannot resume as it stands. Update it to a future time first. If the task has no schedule, add one before using resume.

To choose a future one-time run, use an ISO timestamp with `Z` or a time-zone offset:

```sh
socra task update TASK_ID --at "2030-01-15T09:00:00-07:00"
```

Replace this example with your intended future date and offset. On an active task, this update also resumes scheduling.

## Article details

- Collection: [Tasks](https://support.socra.com/collections/col_01m3xcq6237jk9besmvm5rq8zr-tasks)
- Canonical: https://support.socra.com/articles/art_01m46eky7fqae7pvdxr3qzcc2s-stop-recurring