Property versions

Number of APIs: 6

1. Create a new property version

POST https://{{host}}/papi/v1/properties/:propertyId/versions

Create a new property version based on any previous version. All data from the createFromVersion populates the new version, including its rules and hostnames. Specify createFromVersionEtag if you want to ensure you're creating from a version that hasn't changed since you fetched it.

---

2. List property versions

GET https://{{host}}/papi/v1/properties/:propertyId/versions

Lists the property's versions, with results limited to the 500 most recent versions. Optionally paginate the results. Each property version indicates activation status on different networks, and an etag digest useful when cloning the property.

---

3. Get the latest property version

GET https://{{host}}/papi/v1/properties/:propertyId/versions/latest

This operation provides either the latest property version overall, or the latest one active on the production or staging networks. By default, the response yields the property version with the highest number. Specifying an activatedOn of STAGING or PRODUCTION yields the version that's currently active on either network.

---

4. Get a property version

GET https://{{host}}/papi/v1/properties/:propertyId/versions/:propertyVersion

This polls the state of a specific property version, for example to check its activation status. When specifying Accept: text/xml, this operation provides the Akamai metadata configuration data that's distributed to edge servers when you activate a property version. This XML data encapsulates the property version's component rules and hostnames, and is available on a read-only basis. Contact your Akamai representative if you need help interpreting it.

---

5. List available behaviors for a property

GET https://{{host}}/papi/v1/properties/:propertyId/versions/:propertyVersion/available-behaviors

Lists the set of behaviors you may apply within a property version's rules. The available set depends on the product under which you created the property and any additional modules enabled under your account.

---

6. List available criteria for a property

GET https://{{host}}/papi/v1/properties/:propertyId/versions/:propertyVersion/available-criteria

Lists the set of criteria you may apply within a property version's rules. The available set depends on the product under which you created the property and any additional modules enabled under your account.

---