Skip to main content
DELETE
/
promotions
/
{promotionId}
Delete a specific promotion
curl --request DELETE \
  --url https://api.fabric.inc/v3/promotions/{promotionId} \
  --header 'Authorization: Bearer <token>' \
  --header 'x-fabric-tenant-id: <x-fabric-tenant-id>'
{
  "id": "6380e7ecb419a30009865fad",
  "name": "Black Friday Promotion",
  "status": "SCHEDULED",
  "startAt": "2019-08-24T14:15:22.000Z",
  "endAt": "2019-08-25T14:15:22.000Z",
  "type": "PRODUCT",
  "createdAt": "2019-08-20T14:15:22.000Z",
  "updatedAt": "2019-08-20T14:15:22.000Z",
  "level": 3,
  "stackingType": "STACKABLE",
  "isStackable": false,
  "isAlwaysApplied": false,
  "additionalAttributes": [
    {
      "name": "type",
      "values": "Birthday",
      "attributeId": 100000
    }
  ],
  "promotionMessages": [
    {
      "title": "Buy 2 get 1 free",
      "message": "Offer valid at participating stores through September 5, 2023.",
      "pages": [
        "PDP",
        "Cart"
      ],
      "locales": [
        "en-CA",
        "fr-CA"
      ]
    }
  ]
}

Authorizations

Authorization
string
header
required

Headers

x-fabric-tenant-id
string
required
Required string length: 24
x-fabric-channel-id
string
Example:
x-client-id
string
x-fabric-request-id
string
Example:

Path Parameters

promotionId
string
required

Response

id
string
required
Example:
name
string
required
Example:
status
enum<string>
required
Available options:
ACTIVE,
SCHEDULED,
DISABLED,
EXPIRED
Example:
startAt
string<date-time>
required
Example:
endAt
string<date-time>
required
Example:
type
enum<string>
required
Available options:
PRODUCT,
CART,
QUANTITY,
SHIPPING,
BUYGET,
SPEND_GET
Example:
createdAt
string<date-time>
Example:
updatedAt
string<date-time>
Example:
level
integer
Required range: 0 <= x <= 5
Example:
stackingType
enum<string>
Available options:
STACKABLE,
EXCLUSIVE,
TYPE_EXCLUSIVE,
UNIVERSAL
Example:
isStackable
boolean
Example:
isAlwaysApplied
boolean
Example:
additionalAttributes
object[]
promotionMessages
object[]