> For the complete documentation index, see [llms.txt](https://developer.parvenu.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.parvenu.io/search/job-search/update-or-pause-a-schedule.md).

# Update or Pause a Schedule

Change a schedule's settings, or pause and resume it.

<mark style="color:green;">`POST`</mark> `/jobs_schedule_update`

Changes a saved schedule. **Only the fields you send change**; everything else stays as it is. Any field from [Create a Schedule](/search/job-search/create-a-schedule.md) can be sent, except `listname` and `run_now`.

{% hint style="info" %}
**Free.** `credits_used` is always `0`.
{% endhint %}

{% hint style="success" %}
**Pause and resume with `is_active`.** `false` pauses the schedule: it keeps its settings and dates, and scheduled runs skip it. `true` resumes it. Pausing or resuming on its own never moves `next_run`; a resumed schedule whose date has passed runs at the next daily run.
{% endhint %}

Changing the timing moves `next_run`, counted from the last run.

## Headers

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

## Body

| Name          | Type    | Description                                                                  |
| ------------- | ------- | ---------------------------------------------------------------------------- |
| `api_key`     | string  | **Required.** Your API key.                                                  |
| `schedule_id` | integer | **Required.** From [List Schedules](/search/job-search/list-schedules.md).   |
| `is_active`   | boolean | `false` pauses, `true` resumes.                                              |
| any setting   |         | Any field from [Create a Schedule](/search/job-search/create-a-schedule.md). |

## Response

`data.schedule` is the updated schedule. An id that is not one of yours returns `404`.

## Example

{% tabs %}
{% tab title="Input" %}

```json
{
  "api_key": "your_api_key",
  "schedule_id": 62,
  "is_active": false
}
```

{% endtab %}

{% tab title="Output" %}

```json
{
  "status": "success",
  "credits_used": 0.0,
  "credits_remaining": 6012.5,
  "message": "Updated.",
  "data": {
    "schedule": {
      "schedule_id": 62,
      "list_name": "Roofing Estimator Jobs TX",
      "is_active": false,
      "schedule_type": "weekly",
      "schedule_days": ["Monday"],
      "last_run": "2026-09-29",
      "next_run": "2026-10-05"
    },
    "run_started": false
  }
}
```

{% endtab %}
{% endtabs %}