CalryOTA Docs
Promotions

Update a promotion

Updates an existing promotion

PUT
/api/v1/promotions/{id}

Authorization

x-calry-api-key
x-calry-api-key<token>

In: header

Path Parameters

id*string

Promotion ID

Header Parameters

x-calry-tenant-id?string

Optional tenant ID to specify which tenant to operate as. Controls access to promotions and their associated listings. If not provided, the default tenant will be used.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X PUT "https://example.com/api/v1/promotions/123e4567-e89b-12d3-a456-426614174000" \  -H "Content-Type: application/json" \  -d '{}'
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "Summer Sale 2023",
  "description": "Get 15% off on all summer bookings",
  "city": "San Francisco",
  "discountPercentage": 15,
  "workspaceID": "123e4567-e89b-12d3-a456-426614174000",
  "startDate": "2025-06-01T00:00:00.000Z",
  "endDate": "2025-08-31T23:59:59.999Z",
  "bookingPeriodStart": "2025-06-01",
  "bookingPeriodEnd": "2025-09-30",
  "couponCode": "SUMMER2023",
  "thumbnailURL": "https://example.com/promotions/summer-sale-2023",
  "status": "ACTIVE",
  "createdAt": "2025-05-15T10:30:00.000Z",
  "updatedAt": "2025-05-16T14:45:00.000Z"
}
Empty
{
  "timestamp": "2025-03-05T11:45:49.631Z",
  "path": "<URL_PATH>",
  "message": "Authentication failed",
  "details": []
}
Empty