CTctrlplanedev

List versions eligible for a release target

Changed on

Returns deployment versions that currently pass every policy rule for this release target. An optional CEL filter narrows the result; pagination is applied to the filtered set. Use the "version" variable in the CEL expression to access version properties.

post/v1/workspaces/{workspaceId}/release-targets/{releaseTargetKey}/eligible-versions

Request

  • The document declares no server URL.
  • Auth
    none declared

Path parameters

workspaceIdstring required

ID of the workspace

releaseTargetKeystring required

Key of the release target

Query parameters

limitinteger

Maximum number of items to return

offsetinteger

Number of items to skip

Request body

excludeRuleIdsstring[]

Policy rule IDs to skip during evaluation. Useful when a caller wants to ignore a specific constraint (for example, a versionSelector pin) while still respecting every other rule.

filterstring

CEL expression to filter eligible versions. Defaults to "true" (all eligible versions).

Response

Eligible versions for the release target

limitinteger required

Maximum number of items returned

offsetinteger required

Number of items skipped

totalinteger required

Total number of items available

Changes