Create/Update/Delete Offering Tree Policy

PUT 
/api/v1/catalog/offering/policy

Create/Update/Delete policy, for managing offering tree policy.

Request

application/json

Body

required

platformId number
deviceTypeId number
projectId numberrequired
catalogId objectnullable

Set to null to remove the policy. For backward compat with old format.

rules

object[]

New format: array of filter rules

Array [

type stringrequired

Possible values: [EXACT, RANGE]

EXACT matches a single catalogId, RANGE matches a semver range

value stringrequired

catalogId for EXACT, semver range for RANGE

]

Responses

200

application/json

Schema

Schema

platformId number
deviceTypeId number
projectId numberrequired
catalogId string
latest booleanrequired

rules

object[]

required

Filter rules that define which releases agents can access

Array [

type stringrequired

Possible values: [EXACT, RANGE]

EXACT matches a single catalogId, RANGE matches a semver range

value stringrequired

catalogId for EXACT, semver range for RANGE

]

allowedCatalogIds string[]required

Pre-computed catalogIds allowed by the rules

allowedCount numberrequired

How many versions currently match the rules

createdAt date-timerequired
updatedAt date-timerequired

Example (from schema)

{
  "platformId": 0,
  "deviceTypeId": 0,
  "projectId": 0,
  "catalogId": "string",
  "latest": true,
  "rules": [
    {
      "type": "EXACT",
      "value": "string"
    }
  ],
  "allowedCatalogIds": [
    "string"
  ],
  "allowedCount": 0,
  "createdAt": "2026-11-08T13:48:43.031Z",
  "updatedAt": "2026-11-08T13:48:43.031Z"
}

Loading...