agentVersionsstring[]
will return only environments with on of these agent versions
edgeAsyncboolean
if exists true show only edge async agents, false show only standard edge agents. if missing, will show both types (relevant only for edge agents)
edgeCheckInPassedSecondsnumber
if bigger then zero, show only edge agents that checked-in in the last provided seconds (relevant only for edge agents)
edgeDeviceUntrustedboolean
if true, show only untrusted edge agents, if false show only trusted edge agents (relevant only for edge agents)
edgeGroupIdsinteger[]
List environments(endpoints) of these edge groups
edgeStackIdinteger
will return the environments of the specified edge stack
edgeStackStatusenum
only applied when edgeStackId exists. Filter the returned environments based on their deployment status in the stack (not the environment status!)
endpointIdsinteger[]
will return only these environments(endpoints)
excludeEdgeGroupIdsinteger[]
Exclude environments(endpoints) of these edge groups
excludeGroupIdsinteger[]
Exclude environments of these groups
excludeIdsinteger[]
will exclude these environments(endpoints)
excludeSnapshotsboolean
if true, the snapshot data won't be retrieved
groupIdsinteger[]
List environments(endpoints) of these groups
k8sEnvAdminboolean
If true, an X-K8S-Env-Admin header will be added to the response to indicate if the user is a K8S environment admin for any of the returned environments
limitinteger
Limit results to this value
namestring
will return only environments(endpoints) with this name
nameFilterstring
Filter environments by partial name match (case-insensitive, searches name only)
orderstring
Order sorted results by desc/asc
outdatedboolean
If true, return only environments with an outdated agent
platformTypesenum[]
Filter environments by platform type
policyboolean
If true, will apply policy data to the returned environments(endpoints)
policyIdsinteger[]
List environments(endpoints) associated with these policies
policyStatusenum[]
Filter environments by policy status (applied, failed, in_progress, warning, not_supported). Only applies when policyIds is specified.
provisionedboolean
If true, will return environment(endpoint) that were provisioned
searchstring
Search query
selectstring | null
Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).
sortenum
Sort results by this value
startinteger
Start searching from
statusinteger[]
List environments(endpoints) by this status
tagIdsinteger[]
search environments(endpoints) with these tags (depends on tagsPartialMatch)
tagsPartialMatchboolean
If true, will return environment(endpoint) which has one of tagIds, if false (or missing) will return only environments(endpoints) that has all the tags
typesenum[]
List environments(endpoints) of this type
updateInformationboolean
If true, an X-Update-Available header will be added to the response to indicate if an update is available