Skip to main content

Toggle Offers

Activate or deactivate offers individually. This allows you to quickly enable/disable offers without deleting them.

Toggle Single Offer​

Activate or deactivate a specific offer. The operation toggles the current status (active ↔ draft).

Endpoint​

PUT /v1/offers/{id}/toggle

Path Parameters​

ParameterTypeRequiredDescription
idstringYesOffer ID (UUID)

Request Example​

curl -X PUT "https://sellerapi.ggchest.com/v1/offers/cc0e8400-e29b-41d4-a716-446655440030/toggle" \
  -H "X-API-KEY: your-api-key-here"

Response​

Returns 200 OK on success with no response body.

Behavior​

  • If the offer is currently active, it will be set to draft
  • If the offer is currently draft, it will be set to active
  • Deleted offers cannot be toggled

Error Responses​

403 Forbidden​

Returned when you don't have permission to toggle this offer.

{
  "message": "Forbidden"
}

404 Not Found​

Returned when the offer ID is invalid or the offer doesn't exist.

{
  "message": "Page not found"
}

Notes​

  • Use this endpoint to quickly activate or deactivate offers
  • For batch operations, use the Batch Operations endpoints
  • Toggling a draft offer makes it active and visible to buyers
  • Toggling an active offer makes it draft and hides it from buyers
  • Deleted offers cannot be toggled