Update a query

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

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}}

PreviousGet a saved query NextDelete a query

Last updated 1 year ago

Was this helpful?

PUT /api/v1/assessments/queries/{id} HTTP/1.1 Host: Bearer: YOUR_API_KEY Content-Type: application/json Accept: */* Content-Length: 10058 { "name": "text", "description": "text", "raw_permissions": { "values": [ "text" ], "operator": "AND" }, "effective_permissions": { "values": [ "METADATA_WRITE" ], "operator": "AND" }, "source_node_types": { "nodes": [ { "node_type": "text", "tags": [ { "key": "text", "value": "text" } ], "conditions": [ { "fn": "EQ", "property": "text", "value": null, "not": true, "value_property_name": "text", "value_property_from_other_node": true } ], "condition_expression": { "specs": [ { "fn": "EQ", "property": "text", "value": null, "not": true, "value_property_name": "text", "value_property_from_other_node": true } ], "child_expressions": [ "[Circular Reference]" ], "operator": "AND", "not": true }, "node_id": "text", "excluded_tags": [ { "key": "text", "value": "text" } ], "count_conditions": [ { "fn": "EQ", "value": "text", "value_as": "COUNT" } ], "direct_relationship_only": true, "node_type_grouping_constraint": { "node_types": [ "text" ], "constraint_type": "EXCLUDE" }, "properties_to_get": [ "text" ] } ], "nodes_operator": "AND" }, "required_intermediate_node_types": { "nodes": [ { "node_type": "text", "tags": [ { "key": "text", "value": "text" } ], "conditions": [ { "fn": "EQ", "property": "text", "value": null, "not": true, "value_property_name": "text", "value_property_from_other_node": true } ], "condition_expression": { "specs": [ { "fn": "EQ", "property": "text", "value": null, "not": true, "value_property_name": "text", "value_property_from_other_node": true } ], "child_expressions": [ "[Circular Reference]" ], "operator": "AND", "not": true }, "node_id": "text", "excluded_tags": [ { "key": "text", "value": "text" } ], "count_conditions": [ { "fn": "EQ", "value": "text", "value_as": "COUNT" } ], "direct_relationship_only": true, "node_type_grouping_constraint": { "node_types": [ "text" ], "constraint_type": "EXCLUDE" }, "properties_to_get": [ "text" ] } ], "nodes_operator": "AND" }, "avoided_intermediate_node_types": { "nodes": [ { "node_type": "text", "tags": [ { "key": "text", "value": "text" } ], "conditions": [ { "fn": "EQ", "property": "text", "value": null, "not": true, "value_property_name": "text", "value_property_from_other_node": true } ], "condition_expression": { "specs": [ { "fn": "EQ", "property": "text", "value": null, "not": true, "value_property_name": "text", "value_property_from_other_node": true } ], "child_expressions": [ "[Circular Reference]" ], "operator": "AND", "not": true }, "node_id": "text", "excluded_tags": [ { "key": "text", "value": "text" } ], "count_conditions": [ { "fn": "EQ", "value": "text", "value_as": "COUNT" } ], "direct_relationship_only": true, "node_type_grouping_constraint": { "node_types": [ "text" ], "constraint_type": "EXCLUDE" }, "properties_to_get": [ "text" ] } ], "nodes_operator": "AND" }, "destination_node_types": { "nodes": [ { "node_type": "text", "tags": [ { "key": "text", "value": "text" } ], "conditions": [ { "fn": "EQ", "property": "text", "value": null, "not": true, "value_property_name": "text", "value_property_from_other_node": true } ], "condition_expression": { "specs": [ { "fn": "EQ", "property": "text", "value": null, "not": true, "value_property_name": "text", "value_property_from_other_node": true } ], "child_expressions": [ "[Circular Reference]" ], "operator": "AND", "not": true }, "node_id": "text", "excluded_tags": [ { "key": "text", "value": "text" } ], "count_conditions": [ { "fn": "EQ", "value": "text", "value_as": "COUNT" } ], "direct_relationship_only": true, "node_type_grouping_constraint": { "node_types": [ "text" ], "constraint_type": "EXCLUDE" }, "properties_to_get": [ "text" ] } ], "nodes_operator": "AND" }, "no_relation": true, "visibility": "PUBLIC", "node_relationship_type": "EFFECTIVE_ACCESS", "labels": [ "text" ], "relates_to_exp": { "specs": [ { "node_types": { "nodes": [ { "node_type": "text", "tags": [ { "key": "text", "value": "text" } ], "conditions": [ { "fn": "EQ", "property": "text", "value": null, "not": true, "value_property_name": "text", "value_property_from_other_node": true } ], "condition_expression": { "specs": [ { "fn": "EQ", "property": "text", "value": null, "not": true, "value_property_name": "text", "value_property_from_other_node": true } ], "child_expressions": [ "[Circular Reference]" ], "operator": "AND", "not": true }, "node_id": "text", "excluded_tags": [ { "key": "text", "value": "text" } ], "count_conditions": [ { "fn": "EQ", "value": "text", "value_as": "COUNT" } ], "direct_relationship_only": true, "node_type_grouping_constraint": { "node_types": [ "text" ], "constraint_type": "EXCLUDE" }, "properties_to_get": [ "text" ] } ], "nodes_operator": "AND" }, "required_intermediate_node_types": { "nodes": [ { "node_type": "text", "tags": [ { "key": "text", "value": "text" } ], "conditions": [ { "fn": "EQ", "property": "text", "value": null, "not": true, "value_property_name": "text", "value_property_from_other_node": true } ], "condition_expression": { "specs": [ { "fn": "EQ", "property": "text", "value": null, "not": true, "value_property_name": "text", "value_property_from_other_node": true } ], "child_expressions": [ "[Circular Reference]" ], "operator": "AND", "not": true }, "node_id": "text", "excluded_tags": [ { "key": "text", "value": "text" } ], "count_conditions": [ { "fn": "EQ", "value": "text", "value_as": "COUNT" } ], "direct_relationship_only": true, "node_type_grouping_constraint": { "node_types": [ "text" ], "constraint_type": "EXCLUDE" }, "properties_to_get": [ "text" ] } ], "nodes_operator": "AND" }, "avoided_intermediate_node_types": { "nodes": [ { "node_type": "text", "tags": [ { "key": "text", "value": "text" } ], "conditions": [ { "fn": "EQ", "property": "text", "value": null, "not": true, "value_property_name": "text", "value_property_from_other_node": true } ], "condition_expression": { "specs": [ { "fn": "EQ", "property": "text", "value": null, "not": true, "value_property_name": "text", "value_property_from_other_node": true } ], "child_expressions": [ "[Circular Reference]" ], "operator": "AND", "not": true }, "node_id": "text", "excluded_tags": [ { "key": "text", "value": "text" } ], "count_conditions": [ { "fn": "EQ", "value": "text", "value_as": "COUNT" } ], "direct_relationship_only": true, "node_type_grouping_constraint": { "node_types": [ "text" ], "constraint_type": "EXCLUDE" }, "properties_to_get": [ "text" ] } ], "nodes_operator": "AND" }, "raw_permissions": { "values": [ "text" ], "operator": "AND" }, "effective_permissions": { "values": [ "METADATA_WRITE" ], "operator": "AND" }, "no_relation": true, "direction": "ANY_DIRECTION" } ], "child_expressions": [ { "specs": [ { "node_types": { "nodes": [ { "node_type": "text", "tags": [ { "key": "text", "value": "text" } ], "conditions": [ { "fn": "EQ", "property": "text", "value": null, "not": true, "value_property_name": "text", "value_property_from_other_node": true } ], "condition_expression": { "specs": [ { "fn": "EQ", "property": "text", "value": null, "not": true, "value_property_name": "text", "value_property_from_other_node": true } ], "child_expressions": [ "[Circular Reference]" ], "operator": "AND", "not": true }, "node_id": "text", "excluded_tags": [ { "key": "text", "value": "text" } ], "count_conditions": [ { "fn": "EQ", "value": "text", "value_as": "COUNT" } ], "direct_relationship_only": true, "node_type_grouping_constraint": { "node_types": [ "text" ], "constraint_type": "EXCLUDE" }, "properties_to_get": [ "text" ] } ], "nodes_operator": "AND" }, "required_intermediate_node_types": { "nodes": [ { "node_type": "text", "tags": [ { "key": "text", "value": "text" } ], "conditions": [ { "fn": "EQ", "property": "text", "value": null, "not": true, "value_property_name": "text", "value_property_from_other_node": true } ], "condition_expression": { "specs": [ { "fn": "EQ", "property": "text", "value": null, "not": true, "value_property_name": "text", "value_property_from_other_node": true } ], "child_expressions": [ "[Circular Reference]" ], "operator": "AND", "not": true }, "node_id": "text", "excluded_tags": [ { "key": "text", "value": "text" } ], "count_conditions": [ { "fn": "EQ", "value": "text", "value_as": "COUNT" } ], "direct_relationship_only": true, "node_type_grouping_constraint": { "node_types": [ "text" ], "constraint_type": "EXCLUDE" }, "properties_to_get": [ "text" ] } ], "nodes_operator": "AND" }, "avoided_intermediate_node_types": { "nodes": [ { "node_type": "text", "tags": [ { "key": "text", "value": "text" } ], "conditions": [ { "fn": "EQ", "property": "text", "value": null, "not": true, "value_property_name": "text", "value_property_from_other_node": true } ], "condition_expression": { "specs": [ { "fn": "EQ", "property": "text", "value": null, "not": true, "value_property_name": "text", "value_property_from_other_node": true } ], "child_expressions": [ "[Circular Reference]" ], "operator": "AND", "not": true }, "node_id": "text", "excluded_tags": [ { "key": "text", "value": "text" } ], "count_conditions": [ { "fn": "EQ", "value": "text", "value_as": "COUNT" } ], "direct_relationship_only": true, "node_type_grouping_constraint": { "node_types": [ "text" ], "constraint_type": "EXCLUDE" }, "properties_to_get": [ "text" ] } ], "nodes_operator": "AND" }, "raw_permissions": { "values": [ "text" ], "operator": "AND" }, "effective_permissions": { "values": [ "METADATA_WRITE" ], "operator": "AND" }, "no_relation": true, "direction": "ANY_DIRECTION" } ], "child_expressions": [ { "specs": "[Circular Reference]", "child_expressions": "[Circular Reference]", "operator": "AND", "not": true, "and_op_type": "INFERRED" } ], "operator": "AND", "not": true, "and_op_type": "INFERRED" } ], "operator": "AND", "not": true, "and_op_type": "INFERRED" }, "all_entity_condition": { "specs": [ { "fn": "EQ", "property": "text", "value": null, "not": true, "value_property_name": "text", "value_property_from_other_node": true } ], "child_expressions": [ { "specs": [ { "fn": "EQ", "property": "text", "value": null, "not": true, "value_property_name": "text", "value_property_from_other_node": true } ], "child_expressions": [ { "specs": [ { "fn": "EQ", "property": "text", "value": null, "not": true, "value_property_name": "text", "value_property_from_other_node": true } ], "child_expressions": "[Circular Reference]", "operator": "AND", "not": true } ], "operator": "AND", "not": true } ], "operator": "AND", "not": true }, "path_summary_node_types": { "nodes": [ { "node_type": "text", "tags": [ { "key": "text", "value": "text" } ], "conditions": [ { "fn": "EQ", "property": "text", "value": null, "not": true, "value_property_name": "text", "value_property_from_other_node": true } ], "condition_expression": { "specs": [ { "fn": "EQ", "property": "text", "value": null, "not": true, "value_property_name": "text", "value_property_from_other_node": true } ], "child_expressions": [ "[Circular Reference]" ], "operator": "AND", "not": true }, "node_id": "text", "excluded_tags": [ { "key": "text", "value": "text" } ], "count_conditions": [ { "fn": "EQ", "value": "text", "value_as": "COUNT" } ], "direct_relationship_only": true, "node_type_grouping_constraint": { "node_types": [ "text" ], "constraint_type": "EXCLUDE" }, "properties_to_get": [ "text" ] } ], "nodes_operator": "AND" }, "path_summary_count_conditions": { "conditions": [ { "fn": "EQ", "value": "text", "value_as": "COUNT" } ] }, "analysis_type": "UNSET" }

{ "id": "text", "value": { "id": "text", "name": "text", "description": "text", "result_type": "NUMBER", "query_type": "SYSTEM_CREATED", "raw_permissions": { "values": [ "text" ], "operator": "AND" }, "effective_permissions": { "values": [ "METADATA_WRITE" ], "operator": "AND" }, "variables": [ "text" ], "source_node_types": { "nodes": [ { "node_type": "text", "tags": [ { "key": "text", "value": "text" } ], "conditions": [ { "fn": "EQ", "property": "text", "value": null, "not": true, "value_property_name": "text", "value_property_from_other_node": true } ], "condition_expression": { "specs": [ { "fn": "EQ", "property": "text", "value": null, "not": true, "value_property_name": "text", "value_property_from_other_node": true } ], "child_expressions": "[Circular Reference]", "operator": "AND", "not": true }, "node_id": "text", "excluded_tags": [ { "key": "text", "value": "text" } ], "count_conditions": [ { "fn": "EQ", "value": "text", "value_as": "COUNT" } ], "direct_relationship_only": true, "node_type_grouping_constraint": { "node_types": [ "text" ], "constraint_type": "EXCLUDE" }, "properties_to_get": [ "text" ] } ], "nodes_operator": "AND" }, "required_intermediate_node_types": { "nodes": [ { "node_type": "text", "tags": [ { "key": "text", "value": "text" } ], "conditions": [ { "fn": "EQ", "property": "text", "value": null, "not": true, "value_property_name": "text", "value_property_from_other_node": true } ], "condition_expression": { "specs": [ { "fn": "EQ", "property": "text", "value": null, "not": true, "value_property_name": "text", "value_property_from_other_node": true } ], "child_expressions": "[Circular Reference]", "operator": "AND", "not": true }, "node_id": "text", "excluded_tags": [ { "key": "text", "value": "text" } ], "count_conditions": [ { "fn": "EQ", "value": "text", "value_as": "COUNT" } ], "direct_relationship_only": true, "node_type_grouping_constraint": { "node_types": [ "text" ], "constraint_type": "EXCLUDE" }, "properties_to_get": [ "text" ] } ], "nodes_operator": "AND" }, "avoided_intermediate_node_types": { "nodes": [ { "node_type": "text", "tags": [ { "key": "text", "value": "text" } ], "conditions": [ { "fn": "EQ", "property": "text", "value": null, "not": true, "value_property_name": "text", "value_property_from_other_node": true } ], "condition_expression": { "specs": [ { "fn": "EQ", "property": "text", "value": null, "not": true, "value_property_name": "text", "value_property_from_other_node": true } ], "child_expressions": "[Circular Reference]", "operator": "AND", "not": true }, "node_id": "text", "excluded_tags": [ { "key": "text", "value": "text" } ], "count_conditions": [ { "fn": "EQ", "value": "text", "value_as": "COUNT" } ], "direct_relationship_only": true, "node_type_grouping_constraint": { "node_types": [ "text" ], "constraint_type": "EXCLUDE" }, "properties_to_get": [ "text" ] } ], "nodes_operator": "AND" }, "destination_node_types": { "nodes": [ { "node_type": "text", "tags": [ { "key": "text", "value": "text" } ], "conditions": [ { "fn": "EQ", "property": "text", "value": null, "not": true, "value_property_name": "text", "value_property_from_other_node": true } ], "condition_expression": { "specs": [ { "fn": "EQ", "property": "text", "value": null, "not": true, "value_property_name": "text", "value_property_from_other_node": true } ], "child_expressions": "[Circular Reference]", "operator": "AND", "not": true }, "node_id": "text", "excluded_tags": [ { "key": "text", "value": "text" } ], "count_conditions": [ { "fn": "EQ", "value": "text", "value_as": "COUNT" } ], "direct_relationship_only": true, "node_type_grouping_constraint": { "node_types": [ "text" ], "constraint_type": "EXCLUDE" }, "properties_to_get": [ "text" ] } ], "nodes_operator": "AND" }, "no_relation": true, "created_by": "text", "visibility": "PUBLIC", "owners": [ "text" ], "node_relationship_type": "EFFECTIVE_ACCESS", "integration_types": [ "text" ], "labels": [ "text" ], "created_at": "2025-05-29T10:54:50.746Z", "updated_at": "2025-05-29T10:54:50.746Z", "source_type": "text", "destination_types": [ "text" ], "relates_to_exp": { "specs": [ { "node_types": { "nodes": "[Circular Reference]", "nodes_operator": "AND" }, "required_intermediate_node_types": { "nodes": "[Circular Reference]", "nodes_operator": "AND" }, "avoided_intermediate_node_types": { "nodes": "[Circular Reference]", "nodes_operator": "AND" }, "raw_permissions": { "values": [ "text" ], "operator": "AND" }, "effective_permissions": { "values": [ "METADATA_WRITE" ], "operator": "AND" }, "no_relation": true, "direction": "ANY_DIRECTION" } ], "child_expressions": [ { "specs": [ { "node_types": { "nodes": "[Circular Reference]", "nodes_operator": "AND" }, "required_intermediate_node_types": { "nodes": "[Circular Reference]", "nodes_operator": "AND" }, "avoided_intermediate_node_types": { "nodes": "[Circular Reference]", "nodes_operator": "AND" }, "raw_permissions": { "values": [ "text" ], "operator": "AND" }, "effective_permissions": { "values": [ "METADATA_WRITE" ], "operator": "AND" }, "no_relation": true, "direction": "ANY_DIRECTION" } ], "child_expressions": [ "[Circular Reference]" ], "operator": "AND", "not": true, "and_op_type": "INFERRED" } ], "operator": "AND", "not": true, "and_op_type": "INFERRED" }, "all_entity_condition": { "specs": [ { "fn": "EQ", "property": "text", "value": null, "not": true, "value_property_name": "text", "value_property_from_other_node": true } ], "child_expressions": [ { "specs": [ { "fn": "EQ", "property": "text", "value": null, "not": true, "value_property_name": "text", "value_property_from_other_node": true } ], "child_expressions": [ "[Circular Reference]" ], "operator": "AND", "not": true } ], "operator": "AND", "not": true }, "path_summary_node_types": { "nodes": [ { "node_type": "text", "tags": [ { "key": "text", "value": "text" } ], "conditions": [ { "fn": "EQ", "property": "text", "value": null, "not": true, "value_property_name": "text", "value_property_from_other_node": true } ], "condition_expression": { "specs": [ { "fn": "EQ", "property": "text", "value": null, "not": true, "value_property_name": "text", "value_property_from_other_node": true } ], "child_expressions": "[Circular Reference]", "operator": "AND", "not": true }, "node_id": "text", "excluded_tags": [ { "key": "text", "value": "text" } ], "count_conditions": [ { "fn": "EQ", "value": "text", "value_as": "COUNT" } ], "direct_relationship_only": true, "node_type_grouping_constraint": { "node_types": [ "text" ], "constraint_type": "EXCLUDE" }, "properties_to_get": [ "text" ] } ], "nodes_operator": "AND" }, "path_summary_count_conditions": { "conditions": [ { "fn": "EQ", "value": "text", "value_as": "COUNT" } ] }, "risk_level": "NONE", "risk_suppressed_constraints": { "nodes": [ { "node_type": "text", "tags": [ { "key": "text", "value": "text" } ], "conditions": [ { "fn": "EQ", "property": "text", "value": null, "not": true, "value_property_name": "text", "value_property_from_other_node": true } ], "condition_expression": { "specs": [ { "fn": "EQ", "property": "text", "value": null, "not": true, "value_property_name": "text", "value_property_from_other_node": true } ], "child_expressions": "[Circular Reference]", "operator": "AND", "not": true }, "node_id": "text", "excluded_tags": [ { "key": "text", "value": "text" } ], "count_conditions": [ { "fn": "EQ", "value": "text", "value_as": "COUNT" } ], "direct_relationship_only": true, "node_type_grouping_constraint": { "node_types": [ "text" ], "constraint_type": "EXCLUDE" }, "properties_to_get": [ "text" ] } ] }, "analysis_type": "UNSET", "result": 1, "result_evaluated_at": "2025-05-29T10:54:50.746Z", "result_evaluated": true } }

Responses

200

A successful response.

application/json

401

Authorization information is missing or invalid.

403

Returned when the user does not have permission to access the resource.

404

Returned when the resource does not exist.

500

Server error

502

Returned when the service is temporarily unavailable.

503

Returned when the resource is temporarily unavailable.