Update product (offer) lifecycle state

curl --request PUT \
  --url https://api.fourthwall.com/open-api/v1.0/products/{productId}/state \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "state": "PUBLIC"
}
'

import requests

url = "https://api.fourthwall.com/open-api/v1.0/products/{productId}/state"

payload = { "state": "PUBLIC" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({state: 'PUBLIC'})
};

fetch('https://api.fourthwall.com/open-api/v1.0/products/{productId}/state', 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.fourthwall.com/open-api/v1.0/products/{productId}/state",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'state' => 'PUBLIC'
  ]),
  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://api.fourthwall.com/open-api/v1.0/products/{productId}/state"

	payload := strings.NewReader("{\n  \"state\": \"PUBLIC\"\n}")

	req, _ := http.NewRequest("PUT", 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.put("https://api.fourthwall.com/open-api/v1.0/products/{productId}/state")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"state\": \"PUBLIC\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fourthwall.com/open-api/v1.0/products/{productId}/state")

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

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"state\": \"PUBLIC\"\n}"

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

{
  "id": "00aa4abd-5778-4199-8161-0b49b2f212e5",
  "name": "My t-shirt",
  "slug": "my-t-shirt",
  "description": "My t-shirt description",
  "type": "STANDARD",
  "state": {
    "type": "AVAILABLE"
  },
  "access": {
    "type": "ARCHIVED"
  },
  "images": [
    {
      "id": "00aa4abd-5778-4199-8161-0b49b2f212e5",
      "url": "https://fourthwall.com/image.png",
      "width": 800,
      "height": 600,
      "transformedUrl": "https://fourthwall.com/image.png"
    }
  ],
  "variants": [
    {
      "id": "00aa4abd-5778-4199-8161-0b49b2f212e5",
      "name": "My t-shirt - Black, L",
      "sku": "WDEK-DRE200L",
      "unitPrice": {
        "value": 10,
        "currency": "USD"
      },
      "attributes": {
        "description": "Black, L",
        "color": {
          "name": "Black",
          "swatch": "#000000"
        },
        "size": {
          "name": "L"
        }
      },
      "stock": {
        "type": "LIMITED",
        "inStock": 5
      },
      "weight": {
        "value": 1,
        "unit": "kg"
      },
      "dimensions": {
        "length": 1,
        "width": 2,
        "height": 3,
        "unit": "cm"
      },
      "images": [
        {
          "id": "00aa4abd-5778-4199-8161-0b49b2f212e5",
          "url": "https://fourthwall.com/image.png",
          "width": 800,
          "height": 600,
          "transformedUrl": "https://fourthwall.com/image.png"
        }
      ],
      "compareAtPrice": {
        "value": 10,
        "currency": "USD"
      },
      "unitCost": {
        "value": 10,
        "currency": "USD"
      },
      "creatorDeclaredCost": {
        "value": 10,
        "currency": "USD"
      },
      "thumbnailImage": {
        "id": "00aa4abd-5778-4199-8161-0b49b2f212e5",
        "url": "https://fourthwall.com/image.png",
        "width": 800,
        "height": 600,
        "transformedUrl": "https://fourthwall.com/image.png"
      }
    }
  ],
  "createdAt": "2020-08-13T09:05:36.939Z",
  "updatedAt": "2020-08-13T09:05:36.939Z",
  "thumbnailImage": {
    "id": "00aa4abd-5778-4199-8161-0b49b2f212e5",
    "url": "https://fourthwall.com/image.png",
    "width": 800,
    "height": 600,
    "transformedUrl": "https://fourthwall.com/image.png"
  },
  "additionalInformation": {
    "sizeAndFit": "<string>",
    "guaranteeAndReturns": "<string>",
    "moreDetails": "<string>"
  },
  "sizeGuide": {
    "fitGuideUrls": [
      "<string>"
    ],
    "previewUrl": "<string>",
    "fileUrl": "<string>",
    "description": "<string>",
    "fitGuideDescription": "<string>"
  },
  "digitalFiles": [
    {
      "uri": "https://storage.googleapis.com/bucket/shop/offer/file",
      "name": "my-ebook.pdf",
      "fileSize": "15.4 MB",
      "mediaType": "application/pdf"
    }
  ]
}

PUT

open-api

v1.0

products

{productId}

state

Update product (offer) lifecycle state

curl --request PUT \
  --url https://api.fourthwall.com/open-api/v1.0/products/{productId}/state \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "state": "PUBLIC"
}
'

import requests

url = "https://api.fourthwall.com/open-api/v1.0/products/{productId}/state"

payload = { "state": "PUBLIC" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({state: 'PUBLIC'})
};

fetch('https://api.fourthwall.com/open-api/v1.0/products/{productId}/state', 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.fourthwall.com/open-api/v1.0/products/{productId}/state",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'state' => 'PUBLIC'
  ]),
  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://api.fourthwall.com/open-api/v1.0/products/{productId}/state"

	payload := strings.NewReader("{\n  \"state\": \"PUBLIC\"\n}")

	req, _ := http.NewRequest("PUT", 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.put("https://api.fourthwall.com/open-api/v1.0/products/{productId}/state")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"state\": \"PUBLIC\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fourthwall.com/open-api/v1.0/products/{productId}/state")

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

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"state\": \"PUBLIC\"\n}"

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

{
  "id": "00aa4abd-5778-4199-8161-0b49b2f212e5",
  "name": "My t-shirt",
  "slug": "my-t-shirt",
  "description": "My t-shirt description",
  "type": "STANDARD",
  "state": {
    "type": "AVAILABLE"
  },
  "access": {
    "type": "ARCHIVED"
  },
  "images": [
    {
      "id": "00aa4abd-5778-4199-8161-0b49b2f212e5",
      "url": "https://fourthwall.com/image.png",
      "width": 800,
      "height": 600,
      "transformedUrl": "https://fourthwall.com/image.png"
    }
  ],
  "variants": [
    {
      "id": "00aa4abd-5778-4199-8161-0b49b2f212e5",
      "name": "My t-shirt - Black, L",
      "sku": "WDEK-DRE200L",
      "unitPrice": {
        "value": 10,
        "currency": "USD"
      },
      "attributes": {
        "description": "Black, L",
        "color": {
          "name": "Black",
          "swatch": "#000000"
        },
        "size": {
          "name": "L"
        }
      },
      "stock": {
        "type": "LIMITED",
        "inStock": 5
      },
      "weight": {
        "value": 1,
        "unit": "kg"
      },
      "dimensions": {
        "length": 1,
        "width": 2,
        "height": 3,
        "unit": "cm"
      },
      "images": [
        {
          "id": "00aa4abd-5778-4199-8161-0b49b2f212e5",
          "url": "https://fourthwall.com/image.png",
          "width": 800,
          "height": 600,
          "transformedUrl": "https://fourthwall.com/image.png"
        }
      ],
      "compareAtPrice": {
        "value": 10,
        "currency": "USD"
      },
      "unitCost": {
        "value": 10,
        "currency": "USD"
      },
      "creatorDeclaredCost": {
        "value": 10,
        "currency": "USD"
      },
      "thumbnailImage": {
        "id": "00aa4abd-5778-4199-8161-0b49b2f212e5",
        "url": "https://fourthwall.com/image.png",
        "width": 800,
        "height": 600,
        "transformedUrl": "https://fourthwall.com/image.png"
      }
    }
  ],
  "createdAt": "2020-08-13T09:05:36.939Z",
  "updatedAt": "2020-08-13T09:05:36.939Z",
  "thumbnailImage": {
    "id": "00aa4abd-5778-4199-8161-0b49b2f212e5",
    "url": "https://fourthwall.com/image.png",
    "width": 800,
    "height": 600,
    "transformedUrl": "https://fourthwall.com/image.png"
  },
  "additionalInformation": {
    "sizeAndFit": "<string>",
    "guaranteeAndReturns": "<string>",
    "moreDetails": "<string>"
  },
  "sizeGuide": {
    "fitGuideUrls": [
      "<string>"
    ],
    "previewUrl": "<string>",
    "fileUrl": "<string>",
    "description": "<string>",
    "fitGuideDescription": "<string>"
  },
  "digitalFiles": [
    {
      "uri": "https://storage.googleapis.com/bucket/shop/offer/file",
      "name": "my-ebook.pdf",
      "fileSize": "15.4 MB",
      "mediaType": "application/pdf"
    }
  ]
}

OAuth scope: offer_writeAPI keys have full access to this endpoint.

Authorizations

Authorization

string

header

required

OAuth 2.0 access token, sent as Authorization: Bearer <token>. See https://docs.fourthwall.com/guides/oauth. The scopes an operation requires are listed in its x-fourthwall-scopes.

Path Parameters

productId

string

required

Body

application/json

Request to transition a product (offer) lifecycle state. Only PUBLIC and HIDDEN are reachable via this endpoint — use DELETE /products/{productId} to archive.

state

enum<string>

required

Target lifecycle state. PUBLIC makes the product visible on the storefront; HIDDEN keeps it unlisted. The sold-out (available) flag is preserved across the transition — use PUT /products/{productId}/availability to flip it.

Available options:

PUBLIC,

HIDDEN

Example:

"PUBLIC"

Response

string

required

Example:

"00aa4abd-5778-4199-8161-0b49b2f212e5"

name

string

required

Example:

"My t-shirt"

slug

string

required

Example:

"my-t-shirt"

description

string

required

Example:

"My t-shirt description"

type

enum<string>

required

Available options:

STANDARD,

GIFT_CARD,

UNKNOWN

state

Available · object

required

Available
Available
Sold Out

Show child attributes

access

Archived · object

required

Show child attributes

images

Image · object[]

required

Show child attributes

variants

Offer Variant · object[]

required

Show child attributes

createdAt

string<date-time>

required

Example:

"2020-08-13T09:05:36.939Z"

updatedAt

string<date-time>

required

Example:

"2020-08-13T09:05:36.939Z"

thumbnailImage

Image · object

Show child attributes

additionalInformation

Offer Additional Information · object

Show child attributes

sizeGuide

Offer Size Guide · object

Show child attributes

digitalFiles

Digital File · object[]

Digital files attached to this offer. Only present for digital offers.

Show child attributes

Shop

Products

Product Templates

Customization

Media library

Orders

Fulfillment

Webhooks

Promotions

Memberships

Donations

Mailing Lists

Streaming

Gifting

Giveaway Links

Collections

Thank Yous

Platform Token

Webhook Events

Update product (offer) lifecycle state

Authorizations

Path Parameters

Body

Response