Version

This version element helps in rendering different versions of a product’s document.

Possible Locations

Product

Child Elements

Custom recurrent
Authentication recurrent
Operation recurrent
Server recurrent
Resource recurrent
Tag recurrent

Attributes

Name	Type	Description
value required	String	Version of the resource as configured in the ZSPEC.
display-value	String	The display label of the version.
sdk-languages	String (CSV, enum)	List of the programming languages for which ZEST should generate the SDK samples. The possible values are java, nodejs, php, csharp, python and ruby. By default, samples will be generated for all the ZEST supported languages.

Note:

Since sdk-languages attribute can be given at multiple levels, it follows this Operation > Resource > Version > Product priority order.
If the display-value attribute is not provided, the value will be used for the display label.

Example

By default, the version details will be picked and will hold the <server> and <operation> details.

    
        copy
        
            
        
    
    
         
<version value="1">
    <custom title="Servers">
        <server name="trips.travel_bureau_server" />
    </custom>
    <custom title="Rest APIs">
        <resource name="accommodations" title="Accommodations API">
            <operation name="accommodations.GET accommodations" home-page="true" />
            <operation name="accommodations.POST accommodations" />
            <operation name="accommodations.PUT accommodations" />
            <operation name="accommodations.DELET accommodations" />
        </resource>
        <resource name="destinations" title="Destinations API">
            <operation name="destinations.GET destinations" />
            <operation name="destinations.POST destinations" />
            <operation name="destinations.PUT destinations" />
            <operation name="destinations.DELETE destinations" />
        </resource>
        <resource name="travelers" title="Travelers API">
            <operation name="travelers.GET travelers" />
            <operation name="travelers.POST travelers" />
            <operation name="travelers.PUT travelers" />
            <operation name="travelers.DELETE travelers" />
        </resource>
        <resource name="trips" title="Trips API">
            <operation name="trips.GET trips" />
            <operation name="trips.POST trips" />
            <operation name="trips.PUT trips" />
            <operation name="trips.DELETE trips" />
        </resource>
    </custom>
</version>

Last Updated 2025-05-30 16:54:59 +0530 +0530

Yes

Thank you for your feedback!

Send your feedback to us

Skip

Submit