> ## Documentation Index
> Fetch the complete documentation index at: https://mcp.theoryofevolution.com.au/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Update a Price
> ## Update a Price ##
Update a Price. All fields are optional; you only need to pass in the fields that you want to change. When
editing a live price, a copy will be made of the price in draft status, and the ID of this new price will
be returned in the response body. This means that the existing live price will remain in effect until the
new draft price has gone through our product approval process. On the other hand, edits to draft prices and to
MarketPlace prices which have been directly negotiated between supplier and agent will be made to the existing
Price, and no response body will be returned.
#### Response ####
**Top Level Result Object**
| Field name |
Nullable |
Type |
Description |
| productPricesDetailsId | n | Integer | ID of new Price (if any). |
## OpenAPI
````yaml /openapi/website-travel-supplier-api.mintlify.json put /{supplierapi}/product/{productId}/price/{productPricesDetailsId}
openapi: 3.0.0
info:
title: Website Travel Supplier API
version: 0.0.0
description: >-
Supplier-facing Website Travel API for authentication, products, media,
cancellation policies, and vouchers.
servers: []
security: []
tags:
- name: Version 1
description: Version 1
- name: Media
description: Media
- name: Packages
description: Packages
- name: Booking Details
description: Booking Details
- name: Product Prices
description: Product Prices
- name: Products
description: Products
- name: Vouchers
description: Vouchers
paths:
/{supplierapi}/product/{productId}/price/{productPricesDetailsId}:
put:
tags:
- Version 1
- Product Prices
summary: Update a Price
description: >-
## Update a Price ##
Update a Price. All fields are optional; you only need to pass in the
fields that you want to change. When
editing a live price, a copy will be made of the price in draft status,
and the ID of this new price will
be returned in the response body. This means that the existing live
price will remain in effect until the
new draft price has gone through our product approval process. On the
other hand, edits to draft prices and to
MarketPlace prices which have been directly negotiated between supplier
and agent will be made to the existing
Price, and no response body will be returned.
#### Response ####
**Top Level Result Object**
| Field name |
Nullable |
Type |
Description |
| productPricesDetailsId | n | Integer | ID of new Price (if any). |
operationId: updatePriceAction
parameters:
- name: supplierapi
in: path
required: true
schema:
type: string
pattern: supplier|apiv1/supplier
- name: productId
in: path
required: true
schema:
type: string
pattern: \d+
- name: productPricesDetailsId
in: path
required: true
schema:
type: string
pattern: \d+
requestBody:
description: Update price details for a product.
required: true
content:
application/json:
schema:
required:
- fareTypeCategoryId
properties:
agents:
description: Ids of the agents that have access to this price.
type: array
items:
type: integer
allowEmptyRedeemerDetails:
description: Allow empty redeemer details.
type: boolean
allowOpenDated:
description: Allow open dated bookings.
type: boolean
bookingSystemMapping:
description: >-
Fields used to map product to an external reservation
system.
type: array
items:
type: string
cancellationFeePolicyId:
description: ID of product's cancellation fee policy.
type: integer
childMaxAge:
description: Maximum age for children to be eligible.
type: integer
childMinAge:
description: Minimum age for children to be eligible.
type: integer
defaultFare:
description: Is this the default fare for the Product?
type: boolean
duration:
description: Duration of the tour in days.
type: integer
durationNights:
description: Duration of the tour in nights.
type: integer
earlyBirdLeadDays:
description: Lead time that fare must be booked in advance.
type: integer
fareName:
description: Name of the Fare Type.
type: string
fareQtyRestrictions:
description: Total quantity this fare that agents must select.
type: integer
fareTypeCategoryId:
description: ID of Fare Type Category.
type: integer
levy:
description: Any levy charged on top of RRP at point of travel.
type: number
format: float
levyDescription:
description: Description of levy.
type: string
netRate:
description: Net or wholesale price.
type: number
format: float
note:
description: Any special comments made by Supplier.
type: string
numAdults:
description: Number of adults who are eligible to travel on this fare.
type: integer
numChildren:
description: Number of children who are eligible to travel on this fare.
type: integer
pax:
description: Number of people the price covers.
type: integer
periodEnd:
description: End date of the active period.
type: string
format: date
periodStart:
description: Start date of the active period.
type: string
format: date
packageOnlyFare:
description: Is this a Package only fare?
type: boolean
rrp:
description: Recommended retail price.
type: number
format: float
travelEnd:
description: End date of the travel period.
type: string
format: date
travelStart:
description: Start date of the travel period.
type: string
format: date
type: object
responses:
'201':
description: Returned when new draft price created successfully.
'204':
description: Returned when existing draft price updated successfully.
'400':
description: Returned when there is an issue with the data provided.
'403':
description: Returned when the user is not authorized.
'500':
description: Returned when fatal issues are encountered.
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.