> ## Documentation Index
> Fetch the complete documentation index at: https://reach-owl.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# PATCH/PUT/DELETE /api/v1/post-scheduler/{id} — Update Post Scheduler

> Pause, resume, update fields, delete pending queue rows, or delete the scheduler. No dedicated pause route — use PATCH with status: 0.

Update a post scheduler in place or remove it entirely. There are no dedicated pause or resume endpoints: you control these states by sending a PATCH request with the `status` field.

## Pause a scheduler

Send a PATCH request with `status: 0` to pause the scheduler and stop new posts from being queued.

```bash theme={null}
curl -X PATCH "https://reachowl.com/api/v1/post-scheduler/42" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"status": 0}'
```

## Resume a scheduler

Send a PATCH request with `status: 1` to resume a paused scheduler.

```bash theme={null}
curl -X PATCH "https://reachowl.com/api/v1/post-scheduler/42" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"status": 1}'
```

## Delete pending queue rows

Remove specific pending queue items by passing an array of queue IDs in a PATCH request.

```bash theme={null}
curl -X PATCH "https://reachowl.com/api/v1/post-scheduler/42" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "delete_queue_ids": [101, 102, 103]
  }'
```

## Full update (PUT)

Use PUT to replace the scheduler's name, status, posts, or other editable fields. Include the full body of fields you want to set.

```bash theme={null}
curl -X PUT "https://reachowl.com/api/v1/post-scheduler/42" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated Promos",
    "status": 1,
    "posts": [
      { "text": "New launch announcement!" }
    ]
  }'
```

## Delete a scheduler

Send a DELETE request to permanently remove the scheduler and all associated queue rows.

```bash theme={null}
curl -X DELETE "https://reachowl.com/api/v1/post-scheduler/42" \
  -H "Authorization: Bearer YOUR_TOKEN"
```
