List include versions

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

Recipes
List include versions
Open Recipe
Path Params
string
required

Unique identifier for the include. See ID prefixes for details on omitting the value's inc_ prefix.

Query Params
integer
≥ 0

For paginated responses, specifies the page of results you want to navigate to, starting from 0.

integer
≥ 1

For paginated responses, specifies the number of hostnames objects to include on each page.

string

Unique identifier for the contract. The parameter is optional if a property belongs to only one contract. Otherwise you need to specify it along with the groupId. In other operations that don't specify a propertyId URL parameter, this parameter is always required. See ID prefixes for details on omitting the value's ctr_ prefix.

string

Unique identifier for the group. The parameter is optional if a property belongs to only one group. Otherwise you need to specify it along with the contractId. In other operations that don't specify a propertyId URL parameter, this parameter is always required. See ID prefixes for details on omitting the value's grp_ prefix.

string

For customers who manage more than one account, this runs the operation from another account. The Identity and Access Management API provides a list of available account switch keys.

Headers
string
required

Enum Sets whether to represent ID prefixes in response data. Set to false when exchanging PAPI data with other APIs.

Responses

Response body
object
string

Identifies the prevailing account under which you requested the data. See ID prefixes for details on how to omit the ID's act_ prefix.

string

An alternative identifier for the include. Use this value to key the include in the Identity and Access Management API. See Manage properties and includes.

string

Identifies the prevailing contract under which you requested the data. See ID prefixes for details on how to omit the ID's ctr_ prefix.

string

Identifies the prevailing group under which you requested the data. See ID prefixes for details on how to omit the ID's grp_ prefix.

string

The include's unique identifier. See ID prefixes for details on how to omit the ID's inc_ prefix.

string

A unique, descriptive name for the include. It's not modifiable after you initially create it on a POST request.

string

The type of an include. MICROSERVICES specifies includes with a separate access control and activation flow, which allows different teams to work independently on different parts of a single site. In a parent property's rule tree, you add the MICROSERVICES includes to rules with mutually exclusive path matches. COMMON_SETTINGS specifies includes used across different properties that share a significant number of settings. In a parent property's rule tree, you add the COMMON_SETTINGS includes to the default rule or rules without any matches. By updating or activating a single COMMON_SETTINGS include, the changes take effect immediately across all sites that use this include. You can use this member for filtering and grouping similar includes together.

COMMON_SETTINGS MICROSERVICES

versions
object

The set of requested include versions, available within an items array.

items
array of objects

Specifies the version of an include. Relevant response objects appear within the outer envelope's versions.items array.

items
object
string
required

A digest with which to check the data's integrity. See Concurrency control for guidance.

integer
required
≥ 1

A positive integer identifying the incremental version.

string
required

A descriptive log comment.

string
required

The product assigned to the include when versioned. See ID prefixes for details on how to omit the ID's inc_ prefix.

string
required

Whether the version has been activated to the production network. If ACTIVE, the version is read-only. It's INACTIVE if another version has superseded this one. It's PENDING if the activation request is in progress. It's PENDING_CANCELLATION or ABORTED if the client cancelled a pending activation in time. It's PENDING_DEACTIVATION or DEACTIVATED when set to no longer serve traffic.

ACTIVE INACTIVE PENDING ABORTED DEACTIVATED PENDING_DEACTIVATION PENDING_CANCELLATION

string

Identifies the rule format currently assigned to the include version's rule tree.

string
required

Whether the version has been activated to the test network. If ACTIVE, the version is read-only. It's INACTIVE if another version has superseded this one. It's PENDING if the activation request is in progress. It's PENDING_CANCELLATION or ABORTED if the client cancelled a pending activation in time. It's PENDING_DEACTIVATION or DEACTIVATED when set to no longer serve traffic.

ACTIVE INACTIVE PENDING ABORTED DEACTIVATED PENDING_DEACTIVATION PENDING_CANCELLATION

string
required

The username who last updated the version.

string
required

The date stamp of the version's latest update.

Headers
object
integer

Maximum sustainable number of request allowed each minute per account. This rate limit protects PAPI resources from being exhausted by single users. Once you exceed the limit, you receive the 429 error. If you call PAPI using multiple API clients within the same account, the rate limit applies globally to all API clients.

This API also provides a burst limit that specifies how many requests you can make in excess of the imposed rate limit. The one-time burst limit is 1000 requests. Once you consume all available resources, the burst capacity increases steadily by 100 requests every minute, until it reaches its initial maximum limit of 1000.

integer

Remaining number of requests allowed each minute per account. See Rate and resource limiting for details.

Language
Authentication
URL