Unpublish Content

curl --request POST \
  --url https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/content/{id}/unpublish

import requests

url = "https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/content/{id}/unpublish"

response = requests.post(url)

print(response.text)

const options = {method: 'POST'};

fetch('https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/content/{id}/unpublish', 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://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/content/{id}/unpublish",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/content/{id}/unpublish"

	req, _ := http.NewRequest("POST", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/content/{id}/unpublish")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/content/{id}/unpublish")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)

response = http.request(request)
puts response.read_body

POST

app

organizations

{organizationId}

projects

{projectId}

content

{id}

unpublish

Unpublish Content

curl --request POST \
  --url https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/content/{id}/unpublish

import requests

url = "https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/content/{id}/unpublish"

response = requests.post(url)

print(response.text)

const options = {method: 'POST'};

fetch('https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/content/{id}/unpublish', 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://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/content/{id}/unpublish",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/content/{id}/unpublish"

	req, _ := http.NewRequest("POST", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/content/{id}/unpublish")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/content/{id}/unpublish")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)

response = http.request(request)
puts response.read_body

Changes published content’s status to unpublished without creating a new version. This removes the content from end user access while preserving the version history.

Path Parameters

organizationId

string

required

Organization ID

projectId

string

required

Project ID

string

required

Content ID

Response

Returns the unpublished Content object.

{
  "id": "cont123",
  "typeId": "ct123",
  "typeVersion": 2,
  "version": 2,
  "lastPublishedVersion": 2,
  "packageVersion": "1.0.0",
  "name": "Getting Started Guide",
  "status": "unpublished",
  "isTemplate": false,
  "content": { ... },
  "compiled": "const body = () => { ... }",
  "tags": ["Tutorial"],
  "metadata": { ... },
  "createdAt": "2024-03-20T10:00:00Z",
  "updatedAt": "2024-03-22T10:00:00Z"
}

Unpublishing does not increment the version number. The lastPublishedVersion remains unchanged, allowing you to re-publish at the same version or make modifications first.

Error Responses

Not Published

{
  "error": {
    "code": "INVALID_STATUS",
    "message": "Cannot unpublish: content is not currently published"
  }
}

Code Examples

curl -X POST "https://api.metabind.ai/app/v1/organizations/org123/projects/proj456/content/cont123/unpublish" \
  -H "Authorization: Bearer YOUR_JWT"

const response = await fetch(
  'https://api.metabind.ai/app/v1/organizations/org123/projects/proj456/content/cont123/unpublish',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_JWT'
    }
  }
);

const content = await response.json();
console.log(`Content ${content.name} is now ${content.status}`);

Publish Content List Content Versions

​Path Parameters

​Response

​Error Responses

​Not Published

​Code Examples

Path Parameters

Response

Error Responses

Not Published

Code Examples