Offers

Update an offer

Update an existing offer's details. Can modify name, price, and settings. Note that changing pricing on an active offer may affect existing subscription customers depending on your configuration.

Authorization

Public key Secret key
x-fngs-public-key<token>

In: header

x-fngs-secret-key<token>

In: header

Request Body

application/json

PATCH /v0/offers/:offerId/update Request body

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

PATCH
/v0/offers/{offerId}/update
curl -X PATCH "https://example.com/v0/offers/{offerId}/update" \  -H "Content-Type: application/json" \  -d '{    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"  }'
{  "status": "success",  "data": {    "offer": {      "object": "offer",      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "internalId": null,      "price": -1.7976931348623157e+308,      "originalPrice": null,      "recurringInterval": "day",      "recurringIntervalCount": null,      "trialInterval": "day",      "trialIntervalCount": null,      "currency": "AFN",      "limit": null,      "soldItems": 0,      "status": "DRAFT",      "name": null,      "description": null,      "region": "Global",      "platform": "Meta Quest",      "gtin": null,      "warningMessage": null    }  }}

Get offer details GET

Retrieve detailed information about a specific offer by its ID. Returns the full offer object including product reference, variant details, pricing, subscription settings, and inventory status for key-based products.

Archive an offer PATCH

Archive (soft delete) an offer by its ID. Archived offers can no longer be purchased but existing subscriptions continue. This action is reversible.