---
title: "Service: /publish/schedule [POST]"
source: https://dev.pageseeder.com/api/services/schedule-publish-action-POST.html
description: "POST endpoint to control scheduled publish jobs. Allows three actions on scheduled events: pause (stop execution), continue (resume execution), or start (run immediately). Requires event ID and action parameters."
last_updated: 2026-09-02T11:36:21+10:00
document_type: api_endpoint
operation_id: publish-POST
resource_id: publish
path_template: /publish/schedule
http_method: POST
api_category: publish
implementation_version: 5.8200
api_since: 5.8200
deprecated_since: null
obsolete_since: null
api_support: experimental
cache_control: N/A
generated_at: 2026-09-02
tokens: ~333
---

# /publish/schedule \[POST\]

## Description

“Pause/continue/start” a [scheduled publish job](../../reference/glossary/scheduled_jobs.md).

Three actions are allowed on a scheduled publish event:

- `pause` – stop this event from running when scheduled
- `continue` – run this event at scheduled times (‘unpause’ the event)
- `start` –  run the event immediately (useful for testing)

## Parameters

| Name | Description | Required | Type | Default value |
| --- | --- | --- | --- | --- |
| action | The action on the event (`pause\|continue\|start`) | yes | enum |  |
| eventid | The `ID` of the event to update | yes | string |  |

## Permission

## Response

Following is an example of the XML returned.

```xml

<event id="d539a5998e9655a62fc7cbcc5d32990e"
       process-id="id-22519237f5d798c8db16b080cc729874"
       finished="true"
       paused="true">
  <project>myproject</project>
  <start>2016-02-15T12:29:00+11:00</start>
  <next>2018-10-06T11:29:00+10:00</next>
  <end>2016-07-26T11:30:00+10:00</end>
  [<status>[in-progress|complete|error|cancel]</status>]
  <target name="create-document"> 
    <description>Create Documents</description>
    <param name="max-size" value="10"/>
    <param name="folder" value="reports"/>
  </target>
</event>
```

## Error Handling

No specific errors expected for this service.