---
title: "PATCH /tasks/schedules/{id}/"
method: PATCH
path: "/tasks/schedules/{id}/"
tags: ["tasks"]
---

# PATCH /tasks/schedules/{id}/

`PATCH /tasks/schedules/{id}/`

## Path parameters

- `id` string, uuid, required

## Request body

- PatchedScheduleRequest
  - `rel_obj_id` string, nullable
  - `crontab` string — When to schedule tasks
  - `paused` boolean — Pause this schedule

## Response `200`

- Schedule
  - `id` string, uuid, required
  - `identifier` string, nullable, required — Unique schedule identifier
  - `uid` string, required
  - `actor_name` string, required — Dramatiq actor to call
  - `rel_obj_app_label` string, required
  - `rel_obj_model` string, required
  - `rel_obj_id` string, nullable
  - `crontab` string, required — When to schedule tasks
  - `paused` boolean — Pause this schedule
  - `next_run` string, date-time, required
  - `description` string, nullable, required
  - `last_task_status` 'waiting_for_dependencies' | 'queued' | 'consumed' | 'preprocess' | 'running' | 'postprocess' | 'rejected' | 'done' | 'info' | 'warning' | 'error', required

## Other responses

- `400`
- `403`

---

[API](https://skmtc.dev/goauthentik/apis/authentik.md) · [All operations](https://skmtc.dev/goauthentik/apis/authentik/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/goauthentik/authentik/revisions/4e42e86021d7/schema)