fabric Promotions API declares
1 security scheme
for authenticating requests.
It accepts HTTP bearer tokens (JWT) (AuthorizationToken).
Paths & Operations 8
Across 5 paths, the API surfaces 8 operations — 1 DELETE, 2 GET, 4 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.
Promotions 8
GET
/promotions
Get All Promotions
getPromotions8 params→ 200400401500
POST
/promotions
Create Promotion
createPromotion4 paramsbody→ 201400401500
PUT
/promotions/{promotionId}
Update a Specific Promotion
updatePromotion5 paramsbody→ 200400401404500
GET
/promotions/{promotionId}
Get a Specific Promotion
getPromotion5 params→ 200400401404500
DELETE
/promotions/{promotionId}
Delete a Specific Promotion
deletePromotion5 params→ 200400401404500
POST
/promotions/{promotionId}/actions/toggle
Enable or Disable a Promotion
togglePromotion5 paramsbody→ 200400401404500
POST
/promotions/{promotionId}/actions/end
End a Promotion
endPromotion5 params→ 200400401404500
POST
/promotions/search
Search for Promotions
searchPromotions4 paramsbody→ 200400401500
Schemas 54
The contract defines 54 schemas that model the data the API accepts and returns. The most detailed are promotion (22 properties), createPromotionRequest (19 properties), promoSearchObject (17 properties), promotionResponse (14 properties). Each schema is shown below with its type and property counts.
promotionActiveError
object
Promotion isn't allowed to be updated when it's active
2 properties
promotionTargetProduct
array
A list of target products for applying the discount.
promotionSegment
object
The segment details.
4 properties
searchPromotionRequest
object
The search criteria.
4 properties
promotionAdditionalAttributes
array
Merchant-specified attributes associated with the promotion.
togglePromotionRequest
object
Toggle data request
1 property1 required
proximityMessages
object
2 properties
promotionConditionDetail
object
Represents the conditions based on which the promotions apply. For example, consider the type is USERSEGMENT with multiple values. To target all the specified…
3 properties3 required
createdAt
string
Record's creation time
invalidFilterOperator
object
An error code indicating the filter operation is invalid
2 properties
getPromotionsResponse
object
Promotions list
2 properties
error400
object
Bad request error
2 properties
promotionEndResponse
promotionDeleteError
object
Only upcoming promotions can be deleted
2 properties
offsetQuery
object
Provides pagination data.
3 properties
promotionPriceLists
array
Price list IDs to be considered for this promotion.
badSizeError
object
Pagination size error, an invalid value was sent
2 properties
togglePromotionResponse
promotion
object
Promotion record detail
22 properties7 required
promotionBuyOperatorError
object
Validations for BUYGET promotion don't meet the criteria
2 properties
invalidPromoState
object
An error indicating that the state of the promotion is invalid.
2 properties
promotionLimits
array
Restrictions or conditions that apply to the use of a promotion
promotionNameExists
object
Promotion name duplicated error
2 properties
promotionMessages
array
Message description for the promotion
3 required
promotionDiscountRequired
object
Validations for BUYGET promotion don't meet the criteria
2 properties
promotionResponse
object
The details of the promotion.
14 properties6 required
promotionIsExpired
object
No actions over expired promotions is allowed
2 properties
badSortingError
object
Invalid sorting values sent
2 properties
promotionDiscountError
object
Inconsistent discountId
2 properties
searchPromotionResponse
object
The search results including the pagination data.
2 properties
promotionDateError
object
Inconsistent start and end dates error
2 properties
error401
object
Unauthorized error
2 properties
promotionNotFound
object
Promotion not found error
2 properties
promotionCondition
array
Conditions list for the promotion to be applied
promotionDiscounts
array
An array containing discount details.
promotionDisabledError
object
Promotion can't be activated if it's not disabled
2 properties
promotionConditionUpdate
array
Condition list for the promotion to be qualified
deletePromotionResponse
updatePromotionRequest
promotionShipmentMethods
array
Required for Shipping type promotion to provide eligible shipment methods.
getPromotionResponse
promoSearchObject
object
17 properties
invalidSearchFilterField
object
An error indicating an invalid search.
2 properties
promotionFixedError
object
Validations for the promotion haven't been met
2 properties
missingTenantHeader
object
Tenant header is missing
2 properties
promotionTermsAndConditions
array
Terms and conditions for the promotion
createPromotionResponse
promotionExpired
object
Promotion expired error
2 properties
createPromotionRequest
object
Promotion details to be created
19 properties5 required
invalidPromoStackingType
object
An error indicating the type of promotion stacking is invalid.
2 properties
updatePromotionResponse
error500
object
Internal server error
2 properties
updatedAt
string
Record's last updated time
promotionInvalidId
object
Promotion invalid ID error
2 properties
Specification
The full machine-readable OpenAPI contract behind this narrative.
Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.
Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.
MCP tools for apis
4 tools reach this content
search_api_evangelistSearch every content type across the network at once.
find_relatedThe shared-tag relevance graph — what else covers this.
get_tagEverything one tag labels, across all content types.
guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
A second provider on the same verified email joins the account you already have.
Your account
ⓘWhere this information came from
This is an independent, third-party profile of fabric Promotions API, published by
API Evangelist. We do not operate, host, resell, or
support these APIs, and we are not affiliated with or endorsed by the company unless stated above.
Everything here is built from publicly available information — the company's own site,
developer portal, documentation, public repositories, and the specifications it publishes for public use.
Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's
public API artifacts, scored against a published rubric. They are not certifications,
endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and
you do not need to justify the request. A removed company is recorded as unrated, never scored
zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy → On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.
