---
schema_version: "1"
id: 3e232a22eb011d23adaf1d0c92fe6ed25b1b361957824b30ebc0e14b70e2b50e
title: Publish the Primary Version of an Article
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/service-cloud/knowledge/guides/knowledge-rest-publish-master-version.md
canonical_url: https://developer.salesforce.com/docs/service/salesforce-knowledge-dev-guide/guide/knowledge-rest-publish-master-version.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: c00ec0c6e2345507f9c603725d744d5a9da2ef651e9dadf5f131ed56f4f14efa
products:
  - Salesforce Knowledge Developer Guide
  - Service Cloud Developer Content
---

# Publish the Primary Version of an Article

Publishes the primary version of an article.

**important:** Where possible, we changed noninclusive terms to align with our company value of Equality. We maintained certain terms to avoid any effect on customer implementations.

The publishing actions are defined by the field change you request on the resource. To publish a minor version, use `"publishStatus":"Online"`. To publish a major version, use `"publishStatus":"Online"` and `"versionNumber":"NextVersion"`. To schedule a publication date, use `"publishScheduleDate" : <date>`.

## URI

```nolang
/services/data/v25.0/knowledgeManagement/articleVersions/masterVersions/<versionId>
```

## Formats

JSON, XML

## HTTP Method

PATCH

## Authentication

`Authorization: OAuth {accesstoken}`

## Parameters

| Parameter           | Description                                                                                                                                                        |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| publishStatus       | Publishing status of the article. Use online.                                                                                                                      |
| versionNumber       | Version of the article.                                                                                                                                            |
| publishScheduleDate | Date to publish the article in ISO 8601 format YYYY-`MM-DDTHH:mm:ss+/-HHmm`. For example, for February 8, 2023, 1:40 pm UTC+01:00 use `2023-02-08T13:40:31+0100.`. |

## Input

Publish a minor version:

```nolang
{
    "publishStatus":"Online"
    }
```

Publish a major version:

```nolang
{
    "publishStatus":"Online",
    "versionNumber":"NextVersion"
    }
```

Schedule for publication:

```nolang
{
    "publishScheduleDate" : "2012-05-19T07:00:00+0000"
    }
```

## Output

HTTP status code 204 is returned when an existing record is updated.