Publish or unpublish documents
curl --request POST \
--url https://app.myhero.so/published/publish \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"documentIds": [
"<string>"
],
"isPublished": false
}
'import requests
url = "https://app.myhero.so/published/publish"
payload = {
"documentIds": ["<string>"],
"isPublished": False
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({documentIds: ['<string>'], isPublished: false})
};
fetch('https://app.myhero.so/published/publish', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.myhero.so/published/publish",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'documentIds' => [
'<string>'
],
'isPublished' => false
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.myhero.so/published/publish"
payload := strings.NewReader("{\n \"documentIds\": [\n \"<string>\"\n ],\n \"isPublished\": false\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://app.myhero.so/published/publish")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"documentIds\": [\n \"<string>\"\n ],\n \"isPublished\": false\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.myhero.so/published/publish")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"documentIds\": [\n \"<string>\"\n ],\n \"isPublished\": false\n}"
response = http.request(request)
puts response.read_body{
"data": {
"isPublished": false,
"publishedSettings": {
"publishedById": "<string>",
"publishedAt": 123,
"styling": {},
"domainSlug": "<string>"
}
}
}{
"error": "<string>",
"message": "<string>",
"details": [
"<unknown>"
]
}{
"error": "<string>",
"message": "<string>",
"details": [
"<unknown>"
]
}Published
Publish or unpublish documents
Back-compatible wrapper around POST /published/publish-state (target: "document", state: isPublished ? "on" : "off"). isPublished: true publishes; isPublished: false writes a persistent explicit publishState: "off" on each document, so a caller that unpublishes on a schedule accumulates permanent exclusions rather than merely relaxing to “inherit”.
A folder id cascades to its whole subtree, taking every descendant live or dark with it.
Returns the updated publish settings.
The caller must have edit permission on all supplied documents.
POST
/
published
/
publish
Publish or unpublish documents
curl --request POST \
--url https://app.myhero.so/published/publish \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"documentIds": [
"<string>"
],
"isPublished": false
}
'import requests
url = "https://app.myhero.so/published/publish"
payload = {
"documentIds": ["<string>"],
"isPublished": False
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({documentIds: ['<string>'], isPublished: false})
};
fetch('https://app.myhero.so/published/publish', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.myhero.so/published/publish",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'documentIds' => [
'<string>'
],
'isPublished' => false
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.myhero.so/published/publish"
payload := strings.NewReader("{\n \"documentIds\": [\n \"<string>\"\n ],\n \"isPublished\": false\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://app.myhero.so/published/publish")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"documentIds\": [\n \"<string>\"\n ],\n \"isPublished\": false\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.myhero.so/published/publish")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"documentIds\": [\n \"<string>\"\n ],\n \"isPublished\": false\n}"
response = http.request(request)
puts response.read_body{
"data": {
"isPublished": false,
"publishedSettings": {
"publishedById": "<string>",
"publishedAt": 123,
"styling": {},
"domainSlug": "<string>"
}
}
}{
"error": "<string>",
"message": "<string>",
"details": [
"<unknown>"
]
}{
"error": "<string>",
"message": "<string>",
"details": [
"<unknown>"
]
}