---
title: "Service: /members/{member}/groups/{group}/publish/start [GET]"
source: https://dev.pageseeder.com/api/services/start-group-publish-GET.html
description: "Starts a group publish job using a configured PSML ANT script on the Publish Engine. Requires project, target, and action type parameters. Progress can be monitored via the check service. Guest access or higher required."
last_updated: 2026-09-02T11:36:04+10:00
document_type: api_endpoint
operation_id: publish-GET
resource_id: publish
path_template: /members/{member}/groups/{group}/publish/start
http_method: GET
api_category: publish
implementation_version: 6.3000
api_since: 4.8107
deprecated_since: null
obsolete_since: null
api_support: experimental
cache_control: null
generated_at: 2026-09-02
tokens: ~631
---

# /members/\{member\}/groups/\{group\}/publish/start \[GET\]

## Description

Start a group [publish](../../reference/glossary/publish.md) job.

The target [PSML ANT script](../../guide/configuration/psml/psml_ant_scripts.md) must already be configured on the [Publish Engine](../../reference/glossary/publish_engine.md).

The Publish Engine on a different PageSeeder server can be used by setting the property `publishEngineUrl` in the [global.properties](../../guide/configuration/properties/global_properties.md).

The progress of the job can be monitored by getting the log messages from [Service: /members/\{member\}/publish/check \[GET\]](check-publish-GET.md). The logs for the publish job can be accessed through the Admin user interface and are stored under the following location: `/WEB-INF/state/logs/publisher` .

> **Tip:** To invoke this service from ANT use the [publish task](../../guide/publishing/ant_api/tasks/task_publish.md) which will return logs from the publish action and wait until it is finished.

> **Note:** Parameter values can be used in the ANT script through `${ps.param.[name]}` after calling the `<ps:config />` task. e.g. ```xml <ps:config /> <echo>The xyz parameter is ${ps.param.xyz}</echo> ```

## Parameters

| Name | Description | Required | Type | Default value |
| --- | --- | --- | --- | --- |
| project | The project containing the ANT script | yes | string |  |
| target | The target name in the script | yes | string |  |
| type | The type of action `import\|export\|publish\|process` | yes | enum |  |
| log-level | The level of logging the script outputs `info\|verbose\|warn\|error\|debug` | no | enum | `info` |
| ps-param-\[name\] | The value of a parameter for the script | no | string |  |

## Permission

Requires guest or higher access to the group.

> **Note:** In PageSeeder v5 this service must be accessed with a `jsessionid`from a username/password authentication instead of an OAuth token so that ANT tasks in the publish script can access PageSeeder.

## Response

XML returned:

```xml

<check date="2018-10-08T14:11:51+11:00">
  <publish id="[job ID]">
    <parameters>
      <param name="ps-userFirstname"
             value="[first name]" />
        ...
    </parameters>
    <status>in-progress</status>
    <message logged="false"
             type="in-progress"
             target="starting"
             progress="0">
      Publish Job started
    </message>
  </publish>
</check>
```

## Error Handling

No specific errors expected for this service.