Skip to main content
PUT
/
open-api
/
v1.0
/
products
/
{productId}
/
availability
Update product (offer) availability by id
curl --request PUT \
  --url https://api.fourthwall.com/open-api/v1.0/products/{productId}/availability \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "available": true
}
'
{
  "id": "00aa4abd-5778-4199-8161-0b49b2f212e5",
  "name": "My t-shirt",
  "slug": "my-t-shirt",
  "description": "My t-shirt description",
  "type": "STANDARD",
  "state": {
    "type": "<string>"
  },
  "access": {
    "type": "<string>"
  },
  "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": "<string>",
        "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"
      },
      "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>"
  }
}
This endpoint does not update inventory quantities. It only toggles product visibility on your storefront.
  • Setting available: true makes the product visible and purchasable
  • Setting available: false hides the product from your storefront
To manage actual inventory quantities (e.g., setting stock to 50 units), use the Fourthwall dashboard. The API currently does not support programmatic inventory quantity updates.

​
What this endpoint does

This endpoint controls whether a product appears on your storefront. It accepts a simple boolean toggle: 
{
  "available": true
}
This is useful for:
  • Temporarily hiding products without deleting them
  • Launching products at a specific time by toggling availability
  • Removing discontinued items from your storefront

​
Common misconception

Many developers expect this endpoint to accept inventory quantity updates like: 
{
  "variantId": "...",
  "quantity": 50
}
This is not supported. To view current inventory levels, use the Get Product Inventory endpoint.

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

​
productId
string
required

Body

application/json
​
available
boolean
required

Response

OK

​
id
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
​
access
Archived · object
required
​
images
Image · object[]
required
​
variants
Offer Variant · object[]
required
​
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
​
additionalInformation
Offer Additional Information · object
​
sizeGuide
Offer Size Guide · object