List includes
GET https://{{host}}/papi/v1/includes?contractId={{contractId}}&groupId={{groupId}}
Limited availability This operation lists includes available for the current contract and group. Use optional query parameters to only show includes that were modified within a specified time range or on a selected network. If you specify the modifiedSince parameter, contractId and groupId become optional. If you don't identify a contract and group, the operation lists all includes you have access to, modified within a specified time range.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
modifiedSince | string | (Optional) Filters properties or includes to those modified within a span of time. Use ISO 8601 duration values, with a limit of 30 days expressed as P30D. Values allow additional detail, such as P10DT12H15M for 10 days, 12 hours, and 15 minutes. | |
modifiedNetwork | string | (Optional) Enum Filters and only shows properties or includes that have been modified within a specified period on a selected network, either STAGING, PRODUCTION, or BOTH. You need to specify it along with the modifiedSince query parameter. | |
contractId | string | (Required) Unique identifier for the contract. See ID prefixes for details on omitting the value's ctr_ prefix. | |
groupId | string | (Required) Unique identifier for the group. See ID prefixes for details on omitting the value's grp_ prefix. | |
accountSwitchKey | string | (Optional) 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
| Key | Datatype | Required | Description |
|---|---|---|---|
PAPI-Use-Prefixes | string | (Required) Enum Sets whether to represent ID prefixes in response data. Set to false when exchanging PAPI data with other APIs. | |
Accept | string |
RESPONSES
status: OK
{"includes":{"items":[{"accountId":"act_A-CCT1234","assetId":"aid_101","contractId":"ctr_C-0N7RAC7","groupId":"grp_12345","includeId":"inc_012345678","includeName":"my.new.include.com","includeType":"COMMON_SETTINGS","latestVersion":1,"productionVersion":null,"stagingVersion":null},{"accountId":"act_A-CCT9012","assetId":"aid_102","contractId":"ctr_C-0N7RAC71","groupId":"grp_32145","includeId":"inc_087654321","includeName":"my.new.include2.com","includeType":"MICROSERVICES","latestVersion":1,"productionVersion":null,"stagingVersion":null}]}}