Update a query

UpdateAssessmentQuery updates an existing saved query by id, with the provided full body. Partial updates are not currently supported.

Update Assessment Query

put

Updates an existing saved query by ID. Partial updates are not supported; the full query object must be provided.

Required fields:

• name: Query name
• description: Query description

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer token authentication using a Veza Personal API key.

Header Format: Authorization: Bearer <your-api-key>

Creating an API Key:

1. Log into your Veza tenant
2. Navigate to Administration → API Keys
3. Generate a new API key and save the value securely

Path parameters

idstringRequired

Body

application/json

Request body for updating an existing assessment query.

analysis_typeinteger · enumOptional

This is what view was used to create the assessment query

descriptionstringRequired

Query description. Required for all update operations.

idstringOptional

include_sub_permissionsbooleanOptional

labelsstring[]Optional

namestringRequired

Query name. Required for all update operations.

no_relationbooleanOptionalDeprecated

node_relationship_typeinteger · enumOptional

optionalbooleanOptional

risk_explanationstringOptional

risk_profilesinteger · enum[]Optional

risk_remediationstringOptional

save_modeinteger · enumOptional

visibilityinteger · enumOptional

vql_querystringOptional

Responses

200

OK

application/json

400

Bad Request - Invalid arguments or field violations

application/json

default

Default error response

application/json

put

/api/v1/assessments/queries/{id}

HTTPcURLJavaScriptPython

PUT /api/v1/assessments/queries/{id} HTTP/1.1
Host: your-tenant.vezacloud.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 13278

{
  "access_filter": {
    "anomaly_detection_history_days": "text",
    "engagement_score": {
      "op": 1,
      "value": 1
    },
    "exclude_indirect_grantee": true,
    "include_indirect_resource": true,
    "include_secondary_grantee": true,
    "last_used": {
      "op": 1,
      "relative_timevar_value": "text",
      "target": 1,
      "value": "2026-01-11T18:15:09.185Z"
    },
    "over_provisioned_score": {
      "op": 1,
      "value": 1
    }
  },
  "all_entity_condition": {
    "child_expressions": [
      {
        "child_expressions": [
          {
            "child_expressions": "[Circular Reference]",
            "not": true,
            "operator": 1,
            "specs": [
              {
                "fn": 1,
                "not": true,
                "property": "text",
                "source_property": "text",
                "value": null,
                "value_property_from_other_node": true,
                "value_property_name": "text"
              }
            ],
            "tag_specs": [
              {
                "exclude": true,
                "tag": {
                  "key": "text",
                  "properties": {
                    "ANY_ADDITIONAL_PROPERTY": null
                  },
                  "type": "text",
                  "value": "text"
                }
              }
            ]
          }
        ],
        "not": true,
        "operator": 1,
        "specs": [
          {
            "fn": 1,
            "not": true,
            "property": "text",
            "source_property": "text",
            "value": null,
            "value_property_from_other_node": true,
            "value_property_name": "text"
          }
        ],
        "tag_specs": [
          {
            "exclude": true,
            "tag": {
              "key": "text",
              "properties": {
                "ANY_ADDITIONAL_PROPERTY": null
              },
              "type": "text",
              "value": "text"
            }
          }
        ]
      }
    ],
    "not": true,
    "operator": 1,
    "specs": [
      {
        "fn": 1,
        "not": true,
        "property": "text",
        "source_property": "text",
        "value": null,
        "value_property_from_other_node": true,
        "value_property_name": "text"
      }
    ],
    "tag_specs": [
      {
        "exclude": true,
        "tag": {
          "key": "text",
          "properties": {
            "ANY_ADDITIONAL_PROPERTY": null
          },
          "type": "text",
          "value": "text"
        }
      }
    ]
  },
  "analysis_type": 1,
  "avoided_intermediate_node_types": {
    "nodes": [
      {
        "condition_expression": {
          "child_expressions": [
            {
              "child_expressions": [
                {
                  "child_expressions": "[Circular Reference]",
                  "not": true,
                  "operator": 1,
                  "specs": [
                    {
                      "fn": 1,
                      "not": true,
                      "property": "text",
                      "source_property": "text",
                      "value": null,
                      "value_property_from_other_node": true,
                      "value_property_name": "text"
                    }
                  ],
                  "tag_specs": [
                    {
                      "exclude": true,
                      "tag": {
                        "key": "text",
                        "properties": {
                          "ANY_ADDITIONAL_PROPERTY": null
                        },
                        "type": "text",
                        "value": "text"
                      }
                    }
                  ]
                }
              ],
              "not": true,
              "operator": 1,
              "specs": [
                {
                  "fn": 1,
                  "not": true,
                  "property": "text",
                  "source_property": "text",
                  "value": null,
                  "value_property_from_other_node": true,
                  "value_property_name": "text"
                }
              ],
              "tag_specs": [
                {
                  "exclude": true,
                  "tag": {
                    "key": "text",
                    "properties": {
                      "ANY_ADDITIONAL_PROPERTY": null
                    },
                    "type": "text",
                    "value": "text"
                  }
                }
              ]
            }
          ],
          "not": true,
          "operator": 1,
          "specs": [
            {
              "fn": 1,
              "not": true,
              "property": "text",
              "source_property": "text",
              "value": null,
              "value_property_from_other_node": true,
              "value_property_name": "text"
            }
          ],
          "tag_specs": [
            {
              "exclude": true,
              "tag": {
                "key": "text",
                "properties": {
                  "ANY_ADDITIONAL_PROPERTY": null
                },
                "type": "text",
                "value": "text"
              }
            }
          ]
        },
        "count_condition_expression": {
          "child_expressions": "[Circular Reference]",
          "include_zero_count_results": true,
          "not": true,
          "operator": 1,
          "specs": [
            {
              "fn": 1,
              "value": "text",
              "value_as": 1
            }
          ]
        },
        "direct_relationship_only": true,
        "integration_types": [
          "text"
        ],
        "node_id": "text",
        "node_type": "text",
        "node_type_grouping_constraint": {
          "constraint_type": 1,
          "node_types": [
            "text"
          ]
        },
        "properties_to_get": [
          "text"
        ],
        "tags_to_get": [
          {
            "key": "text",
            "type": 1
          }
        ]
      }
    ],
    "nodes_operator": 1
  },
  "description": "text",
  "destination_node_types": {
    "nodes": [
      {
        "condition_expression": {
          "child_expressions": [
            {
              "child_expressions": [
                {
                  "child_expressions": "[Circular Reference]",
                  "not": true,
                  "operator": 1,
                  "specs": [
                    {
                      "fn": 1,
                      "not": true,
                      "property": "text",
                      "source_property": "text",
                      "value": null,
                      "value_property_from_other_node": true,
                      "value_property_name": "text"
                    }
                  ],
                  "tag_specs": [
                    {
                      "exclude": true,
                      "tag": {
                        "key": "text",
                        "properties": {
                          "ANY_ADDITIONAL_PROPERTY": null
                        },
                        "type": "text",
                        "value": "text"
                      }
                    }
                  ]
                }
              ],
              "not": true,
              "operator": 1,
              "specs": [
                {
                  "fn": 1,
                  "not": true,
                  "property": "text",
                  "source_property": "text",
                  "value": null,
                  "value_property_from_other_node": true,
                  "value_property_name": "text"
                }
              ],
              "tag_specs": [
                {
                  "exclude": true,
                  "tag": {
                    "key": "text",
                    "properties": {
                      "ANY_ADDITIONAL_PROPERTY": null
                    },
                    "type": "text",
                    "value": "text"
                  }
                }
              ]
            }
          ],
          "not": true,
          "operator": 1,
          "specs": [
            {
              "fn": 1,
              "not": true,
              "property": "text",
              "source_property": "text",
              "value": null,
              "value_property_from_other_node": true,
              "value_property_name": "text"
            }
          ],
          "tag_specs": [
            {
              "exclude": true,
              "tag": {
                "key": "text",
                "properties": {
                  "ANY_ADDITIONAL_PROPERTY": null
                },
                "type": "text",
                "value": "text"
              }
            }
          ]
        },
        "count_condition_expression": {
          "child_expressions": "[Circular Reference]",
          "include_zero_count_results": true,
          "not": true,
          "operator": 1,
          "specs": [
            {
              "fn": 1,
              "value": "text",
              "value_as": 1
            }
          ]
        },
        "direct_relationship_only": true,
        "integration_types": [
          "text"
        ],
        "node_id": "text",
        "node_type": "text",
        "node_type_grouping_constraint": {
          "constraint_type": 1,
          "node_types": [
            "text"
          ]
        },
        "properties_to_get": [
          "text"
        ],
        "tags_to_get": [
          {
            "key": "text",
            "type": 1
          }
        ]
      }
    ],
    "nodes_operator": 1
  },
  "effective_permissions": {
    "operator": 1,
    "values": [
      1
    ]
  },
  "id": "text",
  "include_sub_permissions": true,
  "labels": [
    "text"
  ],
  "name": "text",
  "node_relationship_type": 1,
  "optional": true,
  "path_summary_count_conditions": {
    "conditions": [
      {
        "fn": 1,
        "value": "text",
        "value_as": 1
      }
    ]
  },
  "path_summary_node_types": {
    "nodes": [
      {
        "condition_expression": {
          "child_expressions": [
            {
              "child_expressions": [
                {
                  "child_expressions": "[Circular Reference]",
                  "not": true,
                  "operator": 1,
                  "specs": [
                    {
                      "fn": 1,
                      "not": true,
                      "property": "text",
                      "source_property": "text",
                      "value": null,
                      "value_property_from_other_node": true,
                      "value_property_name": "text"
                    }
                  ],
                  "tag_specs": [
                    {
                      "exclude": true,
                      "tag": {
                        "key": "text",
                        "properties": {
                          "ANY_ADDITIONAL_PROPERTY": null
                        },
                        "type": "text",
                        "value": "text"
                      }
                    }
                  ]
                }
              ],
              "not": true,
              "operator": 1,
              "specs": [
                {
                  "fn": 1,
                  "not": true,
                  "property": "text",
                  "source_property": "text",
                  "value": null,
                  "value_property_from_other_node": true,
                  "value_property_name": "text"
                }
              ],
              "tag_specs": [
                {
                  "exclude": true,
                  "tag": {
                    "key": "text",
                    "properties": {
                      "ANY_ADDITIONAL_PROPERTY": null
                    },
                    "type": "text",
                    "value": "text"
                  }
                }
              ]
            }
          ],
          "not": true,
          "operator": 1,
          "specs": [
            {
              "fn": 1,
              "not": true,
              "property": "text",
              "source_property": "text",
              "value": null,
              "value_property_from_other_node": true,
              "value_property_name": "text"
            }
          ],
          "tag_specs": [
            {
              "exclude": true,
              "tag": {
                "key": "text",
                "properties": {
                  "ANY_ADDITIONAL_PROPERTY": null
                },
                "type": "text",
                "value": "text"
              }
            }
          ]
        },
        "count_condition_expression": {
          "child_expressions": "[Circular Reference]",
          "include_zero_count_results": true,
          "not": true,
          "operator": 1,
          "specs": [
            {
              "fn": 1,
              "value": "text",
              "value_as": 1
            }
          ]
        },
        "direct_relationship_only": true,
        "integration_types": [
          "text"
        ],
        "node_id": "text",
        "node_type": "text",
        "node_type_grouping_constraint": {
          "constraint_type": 1,
          "node_types": [
            "text"
          ]
        },
        "properties_to_get": [
          "text"
        ],
        "tags_to_get": [
          {
            "key": "text",
            "type": 1
          }
        ]
      }
    ],
    "nodes_operator": 1
  },
  "raw_permissions": {
    "operator": 1,
    "values": [
      "text"
    ]
  },
  "relates_to_exp": {
    "and_op_type": 1,
    "child_expressions": [
      {
        "and_op_type": 1,
        "child_expressions": [
          "[Circular Reference]"
        ],
        "not": true,
        "operator": 1,
        "specs": [
          "[Circular Reference]"
        ]
      }
    ],
    "not": true,
    "operator": 1,
    "specs": [
      {
        "avoided_intermediate_node_types": {
          "nodes": "[Circular Reference]",
          "nodes_operator": 1
        },
        "direction": 1,
        "effective_permissions": {
          "operator": 1,
          "values": [
            1
          ]
        },
        "no_relation": true,
        "node_types": {
          "nodes": "[Circular Reference]",
          "nodes_operator": 1
        },
        "path_type": 1,
        "raw_permissions": {
          "operator": 1,
          "values": [
            "text"
          ]
        },
        "required_intermediate_node_types": {
          "nodes": "[Circular Reference]",
          "nodes_operator": 1
        },
        "unsupported_condition_mode": 1
      }
    ]
  },
  "required_intermediate_node_types": {
    "nodes": [
      {
        "condition_expression": {
          "child_expressions": [
            {
              "child_expressions": [
                {
                  "child_expressions": "[Circular Reference]",
                  "not": true,
                  "operator": 1,
                  "specs": [
                    {
                      "fn": 1,
                      "not": true,
                      "property": "text",
                      "source_property": "text",
                      "value": null,
                      "value_property_from_other_node": true,
                      "value_property_name": "text"
                    }
                  ],
                  "tag_specs": [
                    {
                      "exclude": true,
                      "tag": {
                        "key": "text",
                        "properties": {
                          "ANY_ADDITIONAL_PROPERTY": null
                        },
                        "type": "text",
                        "value": "text"
                      }
                    }
                  ]
                }
              ],
              "not": true,
              "operator": 1,
              "specs": [
                {
                  "fn": 1,
                  "not": true,
                  "property": "text",
                  "source_property": "text",
                  "value": null,
                  "value_property_from_other_node": true,
                  "value_property_name": "text"
                }
              ],
              "tag_specs": [
                {
                  "exclude": true,
                  "tag": {
                    "key": "text",
                    "properties": {
                      "ANY_ADDITIONAL_PROPERTY": null
                    },
                    "type": "text",
                    "value": "text"
                  }
                }
              ]
            }
          ],
          "not": true,
          "operator": 1,
          "specs": [
            {
              "fn": 1,
              "not": true,
              "property": "text",
              "source_property": "text",
              "value": null,
              "value_property_from_other_node": true,
              "value_property_name": "text"
            }
          ],
          "tag_specs": [
            {
              "exclude": true,
              "tag": {
                "key": "text",
                "properties": {
                  "ANY_ADDITIONAL_PROPERTY": null
                },
                "type": "text",
                "value": "text"
              }
            }
          ]
        },
        "count_condition_expression": {
          "child_expressions": "[Circular Reference]",
          "include_zero_count_results": true,
          "not": true,
          "operator": 1,
          "specs": [
            {
              "fn": 1,
              "value": "text",
              "value_as": 1
            }
          ]
        },
        "direct_relationship_only": true,
        "integration_types": [
          "text"
        ],
        "node_id": "text",
        "node_type": "text",
        "node_type_grouping_constraint": {
          "constraint_type": 1,
          "node_types": [
            "text"
          ]
        },
        "properties_to_get": [
          "text"
        ],
        "tags_to_get": [
          {
            "key": "text",
            "type": 1
          }
        ]
      }
    ],
    "nodes_operator": 1
  },
  "result_enrichment": {
    "include_associated_risks": true,
    "join_node_specs": [
      {
        "as": "text",
        "node_spec": {
          "condition_expression": {
            "child_expressions": [
              {
                "child_expressions": [
                  {
                    "child_expressions": "[Circular Reference]",
                    "not": true,
                    "operator": 1,
                    "specs": [
                      {
                        "fn": 1,
                        "not": true,
                        "property": "text",
                        "source_property": "text",
                        "value": null,
                        "value_property_from_other_node": true,
                        "value_property_name": "text"
                      }
                    ],
                    "tag_specs": [
                      {
                        "exclude": true,
                        "tag": {
                          "key": "text",
                          "properties": {
                            "ANY_ADDITIONAL_PROPERTY": null
                          },
                          "type": "text",
                          "value": "text"
                        }
                      }
                    ]
                  }
                ],
                "not": true,
                "operator": 1,
                "specs": [
                  {
                    "fn": 1,
                    "not": true,
                    "property": "text",
                    "source_property": "text",
                    "value": null,
                    "value_property_from_other_node": true,
                    "value_property_name": "text"
                  }
                ],
                "tag_specs": [
                  {
                    "exclude": true,
                    "tag": {
                      "key": "text",
                      "properties": {
                        "ANY_ADDITIONAL_PROPERTY": null
                      },
                      "type": "text",
                      "value": "text"
                    }
                  }
                ]
              }
            ],
            "not": true,
            "operator": 1,
            "specs": [
              {
                "fn": 1,
                "not": true,
                "property": "text",
                "source_property": "text",
                "value": null,
                "value_property_from_other_node": true,
                "value_property_name": "text"
              }
            ],
            "tag_specs": [
              {
                "exclude": true,
                "tag": {
                  "key": "text",
                  "properties": {
                    "ANY_ADDITIONAL_PROPERTY": null
                  },
                  "type": "text",
                  "value": "text"
                }
              }
            ]
          },
          "count_condition_expression": {
            "child_expressions": "[Circular Reference]",
            "include_zero_count_results": true,
            "not": true,
            "operator": 1,
            "specs": [
              {
                "fn": 1,
                "value": "text",
                "value_as": 1
              }
            ]
          },
          "direct_relationship_only": true,
          "integration_types": [
            "text"
          ],
          "node_id": "text",
          "node_type": "text",
          "node_type_grouping_constraint": {
            "constraint_type": 1,
            "node_types": [
              "text"
            ]
          },
          "properties_to_get": [
            "text"
          ],
          "tags_to_get": [
            {
              "key": "text",
              "type": 1
            }
          ]
        },
        "with": "text"
      }
    ],
    "outlier_detection": {
      "manager_centric_config": {
        "grouping_properties": [
          {
            "joined_node_alias": "text",
            "node_type": "text",
            "property_name": "text",
            "target": 1
          }
        ],
        "threshold": 1
      },
      "type": 1
    },
    "risks_filter": "text"
  },
  "risk_explanation": "text",
  "risk_profiles": [
    1
  ],
  "risk_remediation": "text",
  "save_mode": 1,
  "source_node_types": {
    "nodes": [
      {
        "condition_expression": {
          "child_expressions": [
            {
              "child_expressions": [
                {
                  "child_expressions": "[Circular Reference]",
                  "not": true,
                  "operator": 1,
                  "specs": [
                    {
                      "fn": 1,
                      "not": true,
                      "property": "text",
                      "source_property": "text",
                      "value": null,
                      "value_property_from_other_node": true,
                      "value_property_name": "text"
                    }
                  ],
                  "tag_specs": [
                    {
                      "exclude": true,
                      "tag": {
                        "key": "text",
                        "properties": {
                          "ANY_ADDITIONAL_PROPERTY": null
                        },
                        "type": "text",
                        "value": "text"
                      }
                    }
                  ]
                }
              ],
              "not": true,
              "operator": 1,
              "specs": [
                {
                  "fn": 1,
                  "not": true,
                  "property": "text",
                  "source_property": "text",
                  "value": null,
                  "value_property_from_other_node": true,
                  "value_property_name": "text"
                }
              ],
              "tag_specs": [
                {
                  "exclude": true,
                  "tag": {
                    "key": "text",
                    "properties": {
                      "ANY_ADDITIONAL_PROPERTY": null
                    },
                    "type": "text",
                    "value": "text"
                  }
                }
              ]
            }
          ],
          "not": true,
          "operator": 1,
          "specs": [
            {
              "fn": 1,
              "not": true,
              "property": "text",
              "source_property": "text",
              "value": null,
              "value_property_from_other_node": true,
              "value_property_name": "text"
            }
          ],
          "tag_specs": [
            {
              "exclude": true,
              "tag": {
                "key": "text",
                "properties": {
                  "ANY_ADDITIONAL_PROPERTY": null
                },
                "type": "text",
                "value": "text"
              }
            }
          ]
        },
        "count_condition_expression": {
          "child_expressions": "[Circular Reference]",
          "include_zero_count_results": true,
          "not": true,
          "operator": 1,
          "specs": [
            {
              "fn": 1,
              "value": "text",
              "value_as": 1
            }
          ]
        },
        "direct_relationship_only": true,
        "integration_types": [
          "text"
        ],
        "node_id": "text",
        "node_type": "text",
        "node_type_grouping_constraint": {
          "constraint_type": 1,
          "node_types": [
            "text"
          ]
        },
        "properties_to_get": [
          "text"
        ],
        "tags_to_get": [
          {
            "key": "text",
            "type": 1
          }
        ]
      }
    ],
    "nodes_operator": 1
  },
  "visibility": 1,
  "vql_query": "text",
  "waypoint_nodes": {
    "nodes": [
      {
        "condition_expression": {
          "child_expressions": [
            {
              "child_expressions": [
                {
                  "child_expressions": "[Circular Reference]",
                  "not": true,
                  "operator": 1,
                  "specs": [
                    {
                      "fn": 1,
                      "not": true,
                      "property": "text",
                      "source_property": "text",
                      "value": null,
                      "value_property_from_other_node": true,
                      "value_property_name": "text"
                    }
                  ],
                  "tag_specs": [
                    {
                      "exclude": true,
                      "tag": {
                        "key": "text",
                        "properties": {
                          "ANY_ADDITIONAL_PROPERTY": null
                        },
                        "type": "text",
                        "value": "text"
                      }
                    }
                  ]
                }
              ],
              "not": true,
              "operator": 1,
              "specs": [
                {
                  "fn": 1,
                  "not": true,
                  "property": "text",
                  "source_property": "text",
                  "value": null,
                  "value_property_from_other_node": true,
                  "value_property_name": "text"
                }
              ],
              "tag_specs": [
                {
                  "exclude": true,
                  "tag": {
                    "key": "text",
                    "properties": {
                      "ANY_ADDITIONAL_PROPERTY": null
                    },
                    "type": "text",
                    "value": "text"
                  }
                }
              ]
            }
          ],
          "not": true,
          "operator": 1,
          "specs": [
            {
              "fn": 1,
              "not": true,
              "property": "text",
              "source_property": "text",
              "value": null,
              "value_property_from_other_node": true,
              "value_property_name": "text"
            }
          ],
          "tag_specs": [
            {
              "exclude": true,
              "tag": {
                "key": "text",
                "properties": {
                  "ANY_ADDITIONAL_PROPERTY": null
                },
                "type": "text",
                "value": "text"
              }
            }
          ]
        },
        "count_condition_expression": {
          "child_expressions": "[Circular Reference]",
          "include_zero_count_results": true,
          "not": true,
          "operator": 1,
          "specs": [
            {
              "fn": 1,
              "value": "text",
              "value_as": 1
            }
          ]
        },
        "direct_relationship_only": true,
        "integration_types": [
          "text"
        ],
        "node_id": "text",
        "node_type": "text",
        "node_type_grouping_constraint": {
          "constraint_type": 1,
          "node_types": [
            "text"
          ]
        },
        "properties_to_get": [
          "text"
        ],
        "tags_to_get": [
          {
            "key": "text",
            "type": 1
          }
        ]
      }
    ],
    "nodes_operator": 1
  }
}

{
  "value": {
    "access_filter": {
      "anomaly_detection_history_days": "text",
      "engagement_score": {
        "op": 1,
        "value": 1
      },
      "exclude_indirect_grantee": true,
      "include_indirect_resource": true,
      "include_secondary_grantee": true,
      "last_used": {
        "op": 1,
        "relative_timevar_value": "text",
        "target": 1,
        "value": "2026-01-11T18:15:09.185Z"
      },
      "over_provisioned_score": {
        "op": 1,
        "value": 1
      }
    },
    "all_entity_condition": {
      "child_expressions": [
        {
          "child_expressions": [
            "[Circular Reference]"
          ],
          "not": true,
          "operator": 1,
          "specs": [
            {
              "fn": 1,
              "not": true,
              "property": "text",
              "source_property": "text",
              "value": null,
              "value_property_from_other_node": true,
              "value_property_name": "text"
            }
          ],
          "tag_specs": [
            {
              "exclude": true,
              "tag": {
                "key": "text",
                "properties": {
                  "ANY_ADDITIONAL_PROPERTY": null
                },
                "type": "text",
                "value": "text"
              }
            }
          ]
        }
      ],
      "not": true,
      "operator": 1,
      "specs": [
        {
          "fn": 1,
          "not": true,
          "property": "text",
          "source_property": "text",
          "value": null,
          "value_property_from_other_node": true,
          "value_property_name": "text"
        }
      ],
      "tag_specs": [
        {
          "exclude": true,
          "tag": {
            "key": "text",
            "properties": {
              "ANY_ADDITIONAL_PROPERTY": null
            },
            "type": "text",
            "value": "text"
          }
        }
      ]
    },
    "analysis_type": 1,
    "approx_total_source_nodes_count": "text",
    "avoided_intermediate_node_types": {
      "nodes": [
        {
          "condition_expression": {
            "child_expressions": "[Circular Reference]",
            "not": true,
            "operator": 1,
            "specs": [
              {
                "fn": 1,
                "not": true,
                "property": "text",
                "source_property": "text",
                "value": null,
                "value_property_from_other_node": true,
                "value_property_name": "text"
              }
            ],
            "tag_specs": [
              {
                "exclude": true,
                "tag": {
                  "key": "text",
                  "properties": {
                    "ANY_ADDITIONAL_PROPERTY": null
                  },
                  "type": "text",
                  "value": "text"
                }
              }
            ]
          },
          "count_condition_expression": "[Circular Reference]",
          "direct_relationship_only": true,
          "integration_types": [
            "text"
          ],
          "node_id": "text",
          "node_type": "text",
          "node_type_grouping_constraint": {
            "constraint_type": 1,
            "node_types": [
              "text"
            ]
          },
          "properties_to_get": [
            "text"
          ],
          "tags_to_get": [
            {
              "key": "text",
              "type": 1
            }
          ]
        }
      ],
      "nodes_operator": 1
    },
    "change_source": 1,
    "created_at": "2026-01-11T18:15:09.185Z",
    "created_by": "text",
    "description": "text",
    "destination_node_types": {
      "nodes": [
        {
          "condition_expression": {
            "child_expressions": "[Circular Reference]",
            "not": true,
            "operator": 1,
            "specs": [
              {
                "fn": 1,
                "not": true,
                "property": "text",
                "source_property": "text",
                "value": null,
                "value_property_from_other_node": true,
                "value_property_name": "text"
              }
            ],
            "tag_specs": [
              {
                "exclude": true,
                "tag": {
                  "key": "text",
                  "properties": {
                    "ANY_ADDITIONAL_PROPERTY": null
                  },
                  "type": "text",
                  "value": "text"
                }
              }
            ]
          },
          "count_condition_expression": "[Circular Reference]",
          "direct_relationship_only": true,
          "integration_types": [
            "text"
          ],
          "node_id": "text",
          "node_type": "text",
          "node_type_grouping_constraint": {
            "constraint_type": 1,
            "node_types": [
              "text"
            ]
          },
          "properties_to_get": [
            "text"
          ],
          "tags_to_get": [
            {
              "key": "text",
              "type": 1
            }
          ]
        }
      ],
      "nodes_operator": 1
    },
    "destination_types": [
      "text"
    ],
    "effective_permissions": {
      "operator": 1,
      "values": [
        1
      ]
    },
    "id": "text",
    "include_permissions_summary": true,
    "include_sub_permissions": true,
    "integration_types": [
      "text"
    ],
    "internal_id": "text",
    "labels": [
      "text"
    ],
    "name": "text",
    "natural_language": "text",
    "node_relationship_type": 1,
    "optional": true,
    "owners": [
      "text"
    ],
    "path_summary_count_conditions": {
      "conditions": [
        {
          "fn": 1,
          "value": "text",
          "value_as": 1
        }
      ]
    },
    "path_summary_node_types": {
      "nodes": [
        {
          "condition_expression": {
            "child_expressions": "[Circular Reference]",
            "not": true,
            "operator": 1,
            "specs": [
              {
                "fn": 1,
                "not": true,
                "property": "text",
                "source_property": "text",
                "value": null,
                "value_property_from_other_node": true,
                "value_property_name": "text"
              }
            ],
            "tag_specs": [
              {
                "exclude": true,
                "tag": {
                  "key": "text",
                  "properties": {
                    "ANY_ADDITIONAL_PROPERTY": null
                  },
                  "type": "text",
                  "value": "text"
                }
              }
            ]
          },
          "count_condition_expression": "[Circular Reference]",
          "direct_relationship_only": true,
          "integration_types": [
            "text"
          ],
          "node_id": "text",
          "node_type": "text",
          "node_type_grouping_constraint": {
            "constraint_type": 1,
            "node_types": [
              "text"
            ]
          },
          "properties_to_get": [
            "text"
          ],
          "tags_to_get": [
            {
              "key": "text",
              "type": 1
            }
          ]
        }
      ],
      "nodes_operator": 1
    },
    "query_type": 1,
    "raw_permissions": {
      "operator": 1,
      "values": [
        "text"
      ]
    },
    "relates_to_exp": {
      "and_op_type": 1,
      "child_expressions": [
        {
          "and_op_type": 1,
          "child_expressions": "[Circular Reference]",
          "not": true,
          "operator": 1,
          "specs": "[Circular Reference]"
        }
      ],
      "not": true,
      "operator": 1,
      "specs": [
        {
          "avoided_intermediate_node_types": "[Circular Reference]",
          "direction": 1,
          "effective_permissions": {
            "operator": 1,
            "values": [
              1
            ]
          },
          "no_relation": true,
          "node_types": "[Circular Reference]",
          "path_type": 1,
          "raw_permissions": {
            "operator": 1,
            "values": [
              "text"
            ]
          },
          "required_intermediate_node_types": "[Circular Reference]",
          "unsupported_condition_mode": 1
        }
      ]
    },
    "required_intermediate_node_types": {
      "nodes": [
        {
          "condition_expression": {
            "child_expressions": "[Circular Reference]",
            "not": true,
            "operator": 1,
            "specs": [
              {
                "fn": 1,
                "not": true,
                "property": "text",
                "source_property": "text",
                "value": null,
                "value_property_from_other_node": true,
                "value_property_name": "text"
              }
            ],
            "tag_specs": [
              {
                "exclude": true,
                "tag": {
                  "key": "text",
                  "properties": {
                    "ANY_ADDITIONAL_PROPERTY": null
                  },
                  "type": "text",
                  "value": "text"
                }
              }
            ]
          },
          "count_condition_expression": "[Circular Reference]",
          "direct_relationship_only": true,
          "integration_types": [
            "text"
          ],
          "node_id": "text",
          "node_type": "text",
          "node_type_grouping_constraint": {
            "constraint_type": 1,
            "node_types": [
              "text"
            ]
          },
          "properties_to_get": [
            "text"
          ],
          "tags_to_get": [
            {
              "key": "text",
              "type": 1
            }
          ]
        }
      ],
      "nodes_operator": 1
    },
    "result": 1,
    "result_enrichment": {
      "include_associated_risks": true,
      "join_node_specs": [
        {
          "as": "text",
          "node_spec": "[Circular Reference]",
          "with": "text"
        }
      ],
      "outlier_detection": {
        "manager_centric_config": {
          "grouping_properties": [
            {
              "joined_node_alias": "text",
              "node_type": "text",
              "property_name": "text",
              "target": 1
            }
          ],
          "threshold": 1
        },
        "type": 1
      },
      "risks_filter": "text"
    },
    "result_evaluated": true,
    "result_evaluated_at": "2026-01-11T18:15:09.185Z",
    "result_type": 1,
    "risk_explanation": "text",
    "risk_level": 1,
    "risk_profiles": [
      1
    ],
    "risk_remediation": "text",
    "risk_statistics": {
      "affected_node_count": "text",
      "last_occurred_at": "2026-01-11T18:15:09.185Z",
      "status": 1,
      "suppressed_node_count": "text"
    },
    "risk_suppressed_constraints": {
      "nodes": [
        {
          "condition_expression": {
            "child_expressions": "[Circular Reference]",
            "not": true,
            "operator": 1,
            "specs": [
              {
                "fn": 1,
                "not": true,
                "property": "text",
                "source_property": "text",
                "value": null,
                "value_property_from_other_node": true,
                "value_property_name": "text"
              }
            ],
            "tag_specs": [
              {
                "exclude": true,
                "tag": {
                  "key": "text",
                  "properties": {
                    "ANY_ADDITIONAL_PROPERTY": null
                  },
                  "type": "text",
                  "value": "text"
                }
              }
            ]
          },
          "count_condition_expression": "[Circular Reference]",
          "direct_relationship_only": true,
          "integration_types": [
            "text"
          ],
          "node_id": "text",
          "node_type": "text",
          "node_type_grouping_constraint": {
            "constraint_type": 1,
            "node_types": [
              "text"
            ]
          },
          "properties_to_get": [
            "text"
          ],
          "tags_to_get": [
            {
              "key": "text",
              "type": 1
            }
          ]
        }
      ]
    },
    "save_mode": 1,
    "shared": true,
    "source_node_types": {
      "nodes": [
        {
          "condition_expression": {
            "child_expressions": "[Circular Reference]",
            "not": true,
            "operator": 1,
            "specs": [
              {
                "fn": 1,
                "not": true,
                "property": "text",
                "source_property": "text",
                "value": null,
                "value_property_from_other_node": true,
                "value_property_name": "text"
              }
            ],
            "tag_specs": [
              {
                "exclude": true,
                "tag": {
                  "key": "text",
                  "properties": {
                    "ANY_ADDITIONAL_PROPERTY": null
                  },
                  "type": "text",
                  "value": "text"
                }
              }
            ]
          },
          "count_condition_expression": "[Circular Reference]",
          "direct_relationship_only": true,
          "integration_types": [
            "text"
          ],
          "node_id": "text",
          "node_type": "text",
          "node_type_grouping_constraint": {
            "constraint_type": 1,
            "node_types": [
              "text"
            ]
          },
          "properties_to_get": [
            "text"
          ],
          "tags_to_get": [
            {
              "key": "text",
              "type": 1
            }
          ]
        }
      ],
      "nodes_operator": 1
    },
    "source_type": "text",
    "source_type_integration": "text",
    "team_id": "text",
    "uneditable": true,
    "updated_at": "2026-01-11T18:15:09.185Z",
    "updated_by": "text",
    "variables": [
      "text"
    ],
    "visibility": 1,
    "vql_query": "text",
    "waypoint_nodes": {
      "nodes": [
        {
          "condition_expression": {
            "child_expressions": "[Circular Reference]",
            "not": true,
            "operator": 1,
            "specs": [
              {
                "fn": 1,
                "not": true,
                "property": "text",
                "source_property": "text",
                "value": null,
                "value_property_from_other_node": true,
                "value_property_name": "text"
              }
            ],
            "tag_specs": [
              {
                "exclude": true,
                "tag": {
                  "key": "text",
                  "properties": {
                    "ANY_ADDITIONAL_PROPERTY": null
                  },
                  "type": "text",
                  "value": "text"
                }
              }
            ]
          },
          "count_condition_expression": "[Circular Reference]",
          "direct_relationship_only": true,
          "integration_types": [
            "text"
          ],
          "node_id": "text",
          "node_type": "text",
          "node_type_grouping_constraint": {
            "constraint_type": 1,
            "node_types": [
              "text"
            ]
          },
          "properties_to_get": [
            "text"
          ],
          "tags_to_get": [
            {
              "key": "text",
              "type": 1
            }
          ]
        }
      ],
      "nodes_operator": 1
    }
  }
}

Sample request:

See create query and query parameters for more details on the saved query object.

curl -X 'GET' \
"$BASE_URL/api/v1/assessments/queries/06799e24-cd93-4509-94bc-f00b27ed5e3c" \
-H "authorization: Bearer $VEZA_TOKEN" \
-d '{"source_node_types":{"nodes":[{"node_type":"OktaUser","tags":[],"excluded_tags":[],"count_conditions":[],"direct_relationship_only":false,"node_type_grouping_constraint":null}]},"destination_node_types":{"nodes":[{"node_type":"S3Bucket","tags":[],"excluded_tags":[],"count_conditions":[],"direct_relationship_only":false,"node_type_grouping_constraint":null}]},"node_relationship_type":"EFFECTIVE_ACCESS","no_relation":false,"query_type":"SOURCE_TO_DESTINATION","raw_permissions":null,"effective_permissions":null,"include_nodes":true,"customized_variables":[],"name":"Okta User to S3","description":"updated description","labels":[],"visibility":"PRIVATE"}'

• {id} (path) - string - ID of the query to modify.

Sample response:

A successful response will include the query details within a value object:

{"value":{"id":"06799e24-cd93-4509-94bc-f00b27ed5e3c","name":"Okta User to S3 - time machine","description":"specifies a snapshot to query against","result_type":"NUMBER","query_type":"SOURCE_TO_DESTINATION","raw_permissions":{"values":[],"operator":"AND"},"effective_permissions":{"values":[],"operator":"AND"},"variables":[],"source_node_types":{"nodes":[{"node_type":"OktaUser","tags":[],"conditions":[],"condition_expression":null,"node_id":"","excluded_tags":[],"count_conditions":[],"direct_relationship_only":false,"node_type_grouping_constraint":null}],"nodes_operator":"AND"},"required_intermediate_node_types":{"nodes":[],"nodes_operator":"AND"},"avoided_intermediate_node_types":{"nodes":[],"nodes_operator":"AND"},"destination_node_types":{"nodes":[],"nodes_operator":"AND"},"no_relation":false,"access_filter":null,"created_by":"e3ac5e6a-1946-4688-82a7-8a607133a1c8","visibility":"PRIVATE","owners":["e3ac5e6a-1946-4688-82a7-8a607133a1c8"],"node_relationship_type":"EFFECTIVE_ACCESS","integration_types":["aws","okta"],"labels":[],"created_at":"2023-07-29T20:18:12.781964505Z","updated_at":"2023-07-29T20:18:57.359434701Z","source_type":"OktaUser","destination_types":["S3Bucket"],"relates_to_exp":{"specs":[{"node_types":{"nodes":[{"node_type":"S3Bucket","tags":[],"conditions":[],"condition_expression":null,"node_id":"","excluded_tags":[],"count_conditions":[],"direct_relationship_only":false,"node_type_grouping_constraint":null}],"nodes_operator":"AND"},"required_intermediate_node_types":null,"avoided_intermediate_node_types":null,"raw_permissions":null,"effective_permissions":null,"no_relation":false,"direction":"ANY_DIRECTION"}],"child_expressions":[],"operator":"AND","not":false,"and_op_type":"INFERRED"},"all_entity_condition":{"specs":[],"child_expressions":[],"operator":"AND","not":false},"risk_level":"NONE","risk_suppressed_constraints":null,"analysis_type":"UNSET","result":0,"result_evaluated_at":null,"result_evaluated":false}}