Get query spec results (async)

CreateGetAssessmentQuerySpecResultAsyncRequest submits an assessment query specification for asynchronous execution, returning full result rows.

This is the async equivalent of Get query spec results, for queries that may take longer than the synchronous request timeout allows.

The response contains an AsyncTask with a task ID. Poll the task using GetAssessmentAsyncTask until state reaches COMPLETE (3), then check status for SUCCEEDED (1) or FAILED (2).

Create async assessment query (results)

post

Submit an assessment query specification for asynchronous execution, returning full result rows. Returns a GetAsyncTaskResponse containing an AsyncTask with a task ID. Poll the task status using GetAssessmentAsyncTask until state reaches COMPLETE, then check status for SUCCEEDED or FAILED. The request body uses GetAssessmentQuerySpecResultRequest which defines source entities, relationship expressions (relates_to_exp), and access filters. Migration note: Several fields on the request body are deprecated. Use relates_to_exp instead of destination_node_types, required_intermediate_node_types, avoided_intermediate_node_types, raw_permissions, effective_permissions, and no_relation.

Authorizations

bearerAuth

AuthorizationstringRequired

Veza API key for authentication. Generate keys in Administration > API Keys.

Body

application/json

Assessment query specification defining access relationships to analyze. Specifies source entities, relationship expressions, and permission/access filters for querying the Veza Authorization Graph. Migration note: Several fields are deprecated in favor of relates_to_exp, which provides a more flexible boolean expression syntax for defining access relationships. Deprecated fields: destination_node_types, required_intermediate_node_types, avoided_intermediate_node_types, raw_permissions, effective_permissions, and no_relation.

query_typeinteger · enumOptional

The type of assessment query to execute (enum). Values: 0 = SYSTEM_CREATED, 1 = SOURCE_TO_DESTINATION, 2 = DESTINATION_NODES.

no_relationbooleanOptionalDeprecated

Deprecated. Use relates_to_exp instead. When true, queries for entities with no access relationship.

snapshot_idstringOptional

Optional snapshot ID to query against a specific point-in-time data snapshot.

node_relationship_typeinteger · enumOptional

result_value_typeinteger · enumOptional

Controls the shape of query results. Determines whether results contain source nodes with counts, source-and-destination node pairs, or other result formats.

include_all_source_tags_in_resultsbooleanOptional

These fields control whether or not tags will be included in source and/or destination results

include_all_destination_tags_in_resultsbooleanOptional

additional_columns_to_getinteger · enum[]Optional

Allows FE to Alert BE if permissions are being displayed to the user

include_sub_permissionsbooleanOptional

Include node with sub permissions which is a permission showing for a resource when in reality the permission applies to a subresource.

include_permissions_summarybooleanOptional

This field should be used with AssessmentQueryResultValueType SOURCE_NODES_WITH_COUNTS to include permissions summarized (aggregated) by source node, meaning it contains all permissions used by each source node

unpivot_propertiesstring[]Optional

The properties that should be unpivoted in the results producing multiple rows per node/path To be able to unpivot a property, it must be a list/array type property. If multiple properties are used result will be Cartesian product(all unpivot combinations for node). If property does not exist on a node, and it is a valid property, we will just add that node as is. Syntax to specify properties is the full path to the property using dot notation and using properties json names. Both values and pathValues can be unpivoted:

1. Valid values for unpivoting: properties.<property_name>, unsupported_conditions.<condition_name>.conditions, joined_nodes..<valid_value_for_unpivoting>, raw_permissions, effective_permissions, access_stats.concrete_permissions, access_stats.canonical_permissions, filtered_raw_permissions, corresponding_effective_permissions, additional_node_properties.default_cohort_role_users_in_cohort, additional_node_properties.default_cohort_role_all_common_roles

2. Valid pathValues for unpivoting: unsupported_conditions.<condition_name>.conditions, joined_nodes..<valid_value_for_unpivoting>, source.<valid_value_for_unpivoting>, destination.<valid_value_for_unpivoting>, waypoint.<valid_value_for_unpivoting>, abstract_permissions,concrete_permissions, filtered_concrete_permissions, corresponding_abstract_permissions Examples for Unpivoting values:

3. Single field: unpivot_properties: ["properties.email_addresses"] result_values: {Values: [ {id:"1","properties"{"email_addresses":["[email protected]","[email protected]"]}} ]} After unpivot -> Multiple nodes with id 1: result_values: {Values: [ {id:"1","properties"{"email_addresses":"[email protected]"}}, {id:"1","properties"{"email_addresses":"[email protected]"}} ]}

4. Single field with missing unpivot property: unpivot_properties: ["properties.email_addresses"] result_values: {Values: [ {id:"1","properties"{"permissions": "abc"]}} ]} After unpivot -> Single node with id 1 (no email_addresses property to unpivot): result_values: {Values: [ {id:"1","properties"{"permissions":"abc"}}, ]}

5. Multiple fields - Cartesian Product: unpivot_properties: ["properties.email_addresses", "raw_permissions"] result_values: {Values: [ {id:"1","properties"{"email_addresses":["[email protected]","[email protected]"]}, "raw_permissions":["perm1","perm2"]} ]} After unpivot -> Multiple nodes with id 1: result_values: {Values: [ {id:"1","properties"{"email_addresses":"[email protected]"}, "raw_permissions":"perm1"}, {id:"1","properties"{"email_addresses":"[email protected]"}, "raw_permissions":"perm2"}, {id:"1","properties"{"email_addresses":"[email protected]"}, "raw_permissions":"perm1"}, {id:"1","properties"{"email_addresses":"[email protected]"}, "raw_permissions":"perm2"}, ]}

page_sizestringOptional

The maximum number of results to be returned. Fewer results may be returned even when more pages exist.

page_tokenstringOptional

The token specifying the specific page of results to retrieve.

Responses

200

OK

application/json

Response wrapper containing an async task with its current state, progress, and result.

default

Default error response

application/json

post

/api/v1/assessments/query_spec:result_async_create

HTTPcURLJavaScriptPython

POST /api/v1/assessments/query_spec:result_async_create HTTP/1.1
Host: your-tenant.vezacloud.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 12487

{
  "query_type": 1,
  "source_node_types": {
    "nodes": [
      {
        "node_type": "text",
        "condition_expression": {
          "specs": [
            {
              "fn": 0,
              "property": "email",
              "value": null,
              "not": false,
              "value_property_name": "text",
              "value_property_from_other_node": true,
              "source_property": "text"
            }
          ],
          "tag_specs": [
            {
              "tag": {
                "type": "text",
                "key": "text",
                "value": "text",
                "properties": {
                  "ANY_ADDITIONAL_PROPERTY": null
                }
              },
              "exclude": true,
              "fn": 1,
              "source_query_id": "text",
              "source_tag_key": "text"
            }
          ],
          "child_expressions": [
            "[Circular Reference]"
          ],
          "operator": 0,
          "not": true
        },
        "node_id": "text",
        "count_condition_expression": {
          "specs": [
            {
              "fn": 1,
              "value": "text",
              "value_as": 1
            }
          ],
          "child_expressions": "[Circular Reference]",
          "operator": 1,
          "not": true,
          "include_zero_count_results": true
        },
        "direct_relationship_only": true,
        "node_type_grouping_constraint": {
          "node_types": [
            "text"
          ],
          "constraint_type": 1
        },
        "properties_to_get": [
          "text"
        ],
        "tags_to_get": [
          {
            "type": 1,
            "key": "text"
          }
        ],
        "integration_types": [
          "text"
        ]
      }
    ],
    "nodes_operator": 0
  },
  "customized_variables": [
    {
      "key": "text",
      "value": "text"
    }
  ],
  "snapshot_id": "text",
  "access_filter": {
    "engagement_score": {
      "op": 1,
      "value": 1
    },
    "over_provisioned_score": {
      "op": 1,
      "value": 1
    },
    "include_secondary_grantee": true,
    "include_indirect_resource": true,
    "exclude_indirect_grantee": true,
    "anomaly_detection_history_days": "text",
    "last_used": {
      "op": 1,
      "value": "2026-02-19T20:46:37.966Z",
      "target": 1,
      "relative_timevar_value": "text",
      "not": true
    }
  },
  "node_relationship_type": 1,
  "relates_to_exp": {
    "specs": [
      {
        "node_types": {
          "nodes": "[Circular Reference]",
          "nodes_operator": 0
        },
        "required_intermediate_node_types": {
          "nodes": "[Circular Reference]",
          "nodes_operator": 0
        },
        "avoided_intermediate_node_types": {
          "nodes": "[Circular Reference]",
          "nodes_operator": 0
        },
        "raw_permissions": {
          "values": [
            "text"
          ],
          "operator": 1
        },
        "effective_permissions": {
          "values": [
            1
          ],
          "operator": 1
        },
        "unsupported_condition_mode": 1,
        "no_relation": true,
        "direction": 1,
        "path_type": 1
      }
    ],
    "child_expressions": [
      {
        "specs": [
          {
            "node_types": {
              "nodes": "[Circular Reference]",
              "nodes_operator": 0
            },
            "required_intermediate_node_types": {
              "nodes": "[Circular Reference]",
              "nodes_operator": 0
            },
            "avoided_intermediate_node_types": {
              "nodes": "[Circular Reference]",
              "nodes_operator": 0
            },
            "raw_permissions": {
              "values": [
                "text"
              ],
              "operator": 1
            },
            "effective_permissions": {
              "values": [
                1
              ],
              "operator": 1
            },
            "unsupported_condition_mode": 1,
            "no_relation": true,
            "direction": 1,
            "path_type": 1
          }
        ],
        "child_expressions": [
          "[Circular Reference]"
        ],
        "operator": 1,
        "not": true,
        "and_op_type": 1
      }
    ],
    "operator": 1,
    "not": true,
    "and_op_type": 1
  },
  "path_summary_node_types": {
    "nodes": [
      {
        "node_type": "text",
        "condition_expression": {
          "specs": [
            {
              "fn": 0,
              "property": "email",
              "value": null,
              "not": false,
              "value_property_name": "text",
              "value_property_from_other_node": true,
              "source_property": "text"
            }
          ],
          "tag_specs": [
            {
              "tag": {
                "type": "text",
                "key": "text",
                "value": "text",
                "properties": {
                  "ANY_ADDITIONAL_PROPERTY": null
                }
              },
              "exclude": true,
              "fn": 1,
              "source_query_id": "text",
              "source_tag_key": "text"
            }
          ],
          "child_expressions": [
            "[Circular Reference]"
          ],
          "operator": 0,
          "not": true
        },
        "node_id": "text",
        "count_condition_expression": {
          "specs": [
            {
              "fn": 1,
              "value": "text",
              "value_as": 1
            }
          ],
          "child_expressions": "[Circular Reference]",
          "operator": 1,
          "not": true,
          "include_zero_count_results": true
        },
        "direct_relationship_only": true,
        "node_type_grouping_constraint": {
          "node_types": [
            "text"
          ],
          "constraint_type": 1
        },
        "properties_to_get": [
          "text"
        ],
        "tags_to_get": [
          {
            "type": 1,
            "key": "text"
          }
        ],
        "integration_types": [
          "text"
        ]
      }
    ],
    "nodes_operator": 0
  },
  "all_entity_condition": {
    "specs": [
      {
        "fn": 0,
        "property": "email",
        "value": null,
        "not": false,
        "value_property_name": "text",
        "value_property_from_other_node": true,
        "source_property": "text"
      }
    ],
    "tag_specs": [
      {
        "tag": {
          "type": "text",
          "key": "text",
          "value": "text",
          "properties": {
            "ANY_ADDITIONAL_PROPERTY": null
          }
        },
        "exclude": true,
        "fn": 1,
        "source_query_id": "text",
        "source_tag_key": "text"
      }
    ],
    "child_expressions": [
      {
        "specs": [
          {
            "fn": 0,
            "property": "email",
            "value": null,
            "not": false,
            "value_property_name": "text",
            "value_property_from_other_node": true,
            "source_property": "text"
          }
        ],
        "tag_specs": [
          {
            "tag": {
              "type": "text",
              "key": "text",
              "value": "text",
              "properties": {
                "ANY_ADDITIONAL_PROPERTY": null
              }
            },
            "exclude": true,
            "fn": 1,
            "source_query_id": "text",
            "source_tag_key": "text"
          }
        ],
        "child_expressions": [
          {
            "specs": [
              {
                "fn": 0,
                "property": "email",
                "value": null,
                "not": false,
                "value_property_name": "text",
                "value_property_from_other_node": true,
                "source_property": "text"
              }
            ],
            "tag_specs": [
              {
                "tag": {
                  "type": "text",
                  "key": "text",
                  "value": "text",
                  "properties": {
                    "ANY_ADDITIONAL_PROPERTY": null
                  }
                },
                "exclude": true,
                "fn": 1,
                "source_query_id": "text",
                "source_tag_key": "text"
              }
            ],
            "child_expressions": "[Circular Reference]",
            "operator": 0,
            "not": true
          }
        ],
        "operator": 0,
        "not": true
      }
    ],
    "operator": 0,
    "not": true
  },
  "path_summary_count_conditions": {
    "conditions": [
      {
        "fn": 1,
        "value": "text",
        "value_as": 1
      }
    ]
  },
  "result_value_type": 1,
  "include_all_source_tags_in_results": true,
  "include_all_destination_tags_in_results": true,
  "additional_columns_to_get": [
    1
  ],
  "result_enrichment": {
    "join_node_specs": [
      {
        "with": "text",
        "node_spec": {
          "node_type": "text",
          "condition_expression": {
            "specs": [
              {
                "fn": 0,
                "property": "email",
                "value": null,
                "not": false,
                "value_property_name": "text",
                "value_property_from_other_node": true,
                "source_property": "text"
              }
            ],
            "tag_specs": [
              {
                "tag": {
                  "type": "text",
                  "key": "text",
                  "value": "text",
                  "properties": {
                    "ANY_ADDITIONAL_PROPERTY": null
                  }
                },
                "exclude": true,
                "fn": 1,
                "source_query_id": "text",
                "source_tag_key": "text"
              }
            ],
            "child_expressions": [
              "[Circular Reference]"
            ],
            "operator": 0,
            "not": true
          },
          "node_id": "text",
          "count_condition_expression": {
            "specs": [
              {
                "fn": 1,
                "value": "text",
                "value_as": 1
              }
            ],
            "child_expressions": "[Circular Reference]",
            "operator": 1,
            "not": true,
            "include_zero_count_results": true
          },
          "direct_relationship_only": true,
          "node_type_grouping_constraint": {
            "node_types": [
              "text"
            ],
            "constraint_type": 1
          },
          "properties_to_get": [
            "text"
          ],
          "tags_to_get": [
            {
              "type": 1,
              "key": "text"
            }
          ],
          "integration_types": [
            "text"
          ]
        },
        "as": "text"
      }
    ],
    "outlier_detection": {
      "type": 1,
      "manager_centric_config": {
        "grouping_properties": [
          {
            "property_name": "text",
            "node_type": "text",
            "target": 1,
            "joined_node_alias": "text"
          }
        ],
        "threshold": 1
      }
    },
    "include_associated_risks": true,
    "risks_filter": "text"
  },
  "include_sub_permissions": true,
  "include_permissions_summary": true,
  "waypoint_nodes": {
    "nodes": [
      {
        "node_type": "text",
        "condition_expression": {
          "specs": [
            {
              "fn": 0,
              "property": "email",
              "value": null,
              "not": false,
              "value_property_name": "text",
              "value_property_from_other_node": true,
              "source_property": "text"
            }
          ],
          "tag_specs": [
            {
              "tag": {
                "type": "text",
                "key": "text",
                "value": "text",
                "properties": {
                  "ANY_ADDITIONAL_PROPERTY": null
                }
              },
              "exclude": true,
              "fn": 1,
              "source_query_id": "text",
              "source_tag_key": "text"
            }
          ],
          "child_expressions": [
            "[Circular Reference]"
          ],
          "operator": 0,
          "not": true
        },
        "node_id": "text",
        "count_condition_expression": {
          "specs": [
            {
              "fn": 1,
              "value": "text",
              "value_as": 1
            }
          ],
          "child_expressions": "[Circular Reference]",
          "operator": 1,
          "not": true,
          "include_zero_count_results": true
        },
        "direct_relationship_only": true,
        "node_type_grouping_constraint": {
          "node_types": [
            "text"
          ],
          "constraint_type": 1
        },
        "properties_to_get": [
          "text"
        ],
        "tags_to_get": [
          {
            "type": 1,
            "key": "text"
          }
        ],
        "integration_types": [
          "text"
        ]
      }
    ],
    "nodes_operator": 0
  },
  "unpivot_properties": [
    "text"
  ],
  "union_specs": [
    {
      "query_type": 1,
      "source_node_types": {
        "nodes": [
          {
            "node_type": "text",
            "condition_expression": {
              "specs": [
                {
                  "fn": 0,
                  "property": "email",
                  "value": null,
                  "not": false,
                  "value_property_name": "text",
                  "value_property_from_other_node": true,
                  "source_property": "text"
                }
              ],
              "tag_specs": [
                {
                  "tag": {
                    "type": "text",
                    "key": "text",
                    "value": "text",
                    "properties": {
                      "ANY_ADDITIONAL_PROPERTY": null
                    }
                  },
                  "exclude": true,
                  "fn": 1,
                  "source_query_id": "text",
                  "source_tag_key": "text"
                }
              ],
              "child_expressions": [
                "[Circular Reference]"
              ],
              "operator": 0,
              "not": true
            },
            "node_id": "text",
            "count_condition_expression": {
              "specs": [
                {
                  "fn": 1,
                  "value": "text",
                  "value_as": 1
                }
              ],
              "child_expressions": "[Circular Reference]",
              "operator": 1,
              "not": true,
              "include_zero_count_results": true
            },
            "direct_relationship_only": true,
            "node_type_grouping_constraint": {
              "node_types": [
                "text"
              ],
              "constraint_type": 1
            },
            "properties_to_get": [
              "text"
            ],
            "tags_to_get": [
              {
                "type": 1,
                "key": "text"
              }
            ],
            "integration_types": [
              "text"
            ]
          }
        ],
        "nodes_operator": 0
      },
      "customized_variables": [
        {
          "key": "text",
          "value": "text"
        }
      ],
      "access_filter": {
        "engagement_score": {
          "op": 1,
          "value": 1
        },
        "over_provisioned_score": {
          "op": 1,
          "value": 1
        },
        "include_secondary_grantee": true,
        "include_indirect_resource": true,
        "exclude_indirect_grantee": true,
        "anomaly_detection_history_days": "text",
        "last_used": {
          "op": 1,
          "value": "2026-02-19T20:46:37.966Z",
          "target": 1,
          "relative_timevar_value": "text",
          "not": true
        }
      },
      "node_relationship_type": 1,
      "relates_to_exp": {
        "specs": [
          {
            "node_types": {
              "nodes": "[Circular Reference]",
              "nodes_operator": 0
            },
            "required_intermediate_node_types": {
              "nodes": "[Circular Reference]",
              "nodes_operator": 0
            },
            "avoided_intermediate_node_types": {
              "nodes": "[Circular Reference]",
              "nodes_operator": 0
            },
            "raw_permissions": {
              "values": [
                "text"
              ],
              "operator": 1
            },
            "effective_permissions": {
              "values": [
                1
              ],
              "operator": 1
            },
            "unsupported_condition_mode": 1,
            "no_relation": true,
            "direction": 1,
            "path_type": 1
          }
        ],
        "child_expressions": [
          {
            "specs": [
              {
                "node_types": {
                  "nodes": "[Circular Reference]",
                  "nodes_operator": 0
                },
                "required_intermediate_node_types": {
                  "nodes": "[Circular Reference]",
                  "nodes_operator": 0
                },
                "avoided_intermediate_node_types": {
                  "nodes": "[Circular Reference]",
                  "nodes_operator": 0
                },
                "raw_permissions": {
                  "values": [
                    "text"
                  ],
                  "operator": 1
                },
                "effective_permissions": {
                  "values": [
                    1
                  ],
                  "operator": 1
                },
                "unsupported_condition_mode": 1,
                "no_relation": true,
                "direction": 1,
                "path_type": 1
              }
            ],
            "child_expressions": [
              "[Circular Reference]"
            ],
            "operator": 1,
            "not": true,
            "and_op_type": 1
          }
        ],
        "operator": 1,
        "not": true,
        "and_op_type": 1
      },
      "path_summary_node_types": {
        "nodes": [
          {
            "node_type": "text",
            "condition_expression": {
              "specs": [
                {
                  "fn": 0,
                  "property": "email",
                  "value": null,
                  "not": false,
                  "value_property_name": "text",
                  "value_property_from_other_node": true,
                  "source_property": "text"
                }
              ],
              "tag_specs": [
                {
                  "tag": {
                    "type": "text",
                    "key": "text",
                    "value": "text",
                    "properties": {
                      "ANY_ADDITIONAL_PROPERTY": null
                    }
                  },
                  "exclude": true,
                  "fn": 1,
                  "source_query_id": "text",
                  "source_tag_key": "text"
                }
              ],
              "child_expressions": [
                "[Circular Reference]"
              ],
              "operator": 0,
              "not": true
            },
            "node_id": "text",
            "count_condition_expression": {
              "specs": [
                {
                  "fn": 1,
                  "value": "text",
                  "value_as": 1
                }
              ],
              "child_expressions": "[Circular Reference]",
              "operator": 1,
              "not": true,
              "include_zero_count_results": true
            },
            "direct_relationship_only": true,
            "node_type_grouping_constraint": {
              "node_types": [
                "text"
              ],
              "constraint_type": 1
            },
            "properties_to_get": [
              "text"
            ],
            "tags_to_get": [
              {
                "type": 1,
                "key": "text"
              }
            ],
            "integration_types": [
              "text"
            ]
          }
        ],
        "nodes_operator": 0
      },
      "all_entity_condition": {
        "specs": [
          {
            "fn": 0,
            "property": "email",
            "value": null,
            "not": false,
            "value_property_name": "text",
            "value_property_from_other_node": true,
            "source_property": "text"
          }
        ],
        "tag_specs": [
          {
            "tag": {
              "type": "text",
              "key": "text",
              "value": "text",
              "properties": {
                "ANY_ADDITIONAL_PROPERTY": null
              }
            },
            "exclude": true,
            "fn": 1,
            "source_query_id": "text",
            "source_tag_key": "text"
          }
        ],
        "child_expressions": [
          {
            "specs": [
              {
                "fn": 0,
                "property": "email",
                "value": null,
                "not": false,
                "value_property_name": "text",
                "value_property_from_other_node": true,
                "source_property": "text"
              }
            ],
            "tag_specs": [
              {
                "tag": {
                  "type": "text",
                  "key": "text",
                  "value": "text",
                  "properties": {
                    "ANY_ADDITIONAL_PROPERTY": null
                  }
                },
                "exclude": true,
                "fn": 1,
                "source_query_id": "text",
                "source_tag_key": "text"
              }
            ],
            "child_expressions": [
              {
                "specs": [
                  {
                    "fn": 0,
                    "property": "email",
                    "value": null,
                    "not": false,
                    "value_property_name": "text",
                    "value_property_from_other_node": true,
                    "source_property": "text"
                  }
                ],
                "tag_specs": [
                  {
                    "tag": {
                      "type": "text",
                      "key": "text",
                      "value": "text",
                      "properties": {
                        "ANY_ADDITIONAL_PROPERTY": null
                      }
                    },
                    "exclude": true,
                    "fn": 1,
                    "source_query_id": "text",
                    "source_tag_key": "text"
                  }
                ],
                "child_expressions": "[Circular Reference]",
                "operator": 0,
                "not": true
              }
            ],
            "operator": 0,
            "not": true
          }
        ],
        "operator": 0,
        "not": true
      },
      "path_summary_count_conditions": {
        "conditions": [
          {
            "fn": 1,
            "value": "text",
            "value_as": 1
          }
        ]
      },
      "waypoint_nodes": {
        "nodes": [
          {
            "node_type": "text",
            "condition_expression": {
              "specs": [
                {
                  "fn": 0,
                  "property": "email",
                  "value": null,
                  "not": false,
                  "value_property_name": "text",
                  "value_property_from_other_node": true,
                  "source_property": "text"
                }
              ],
              "tag_specs": [
                {
                  "tag": {
                    "type": "text",
                    "key": "text",
                    "value": "text",
                    "properties": {
                      "ANY_ADDITIONAL_PROPERTY": null
                    }
                  },
                  "exclude": true,
                  "fn": 1,
                  "source_query_id": "text",
                  "source_tag_key": "text"
                }
              ],
              "child_expressions": [
                "[Circular Reference]"
              ],
              "operator": 0,
              "not": true
            },
            "node_id": "text",
            "count_condition_expression": {
              "specs": [
                {
                  "fn": 1,
                  "value": "text",
                  "value_as": 1
                }
              ],
              "child_expressions": "[Circular Reference]",
              "operator": 1,
              "not": true,
              "include_zero_count_results": true
            },
            "direct_relationship_only": true,
            "node_type_grouping_constraint": {
              "node_types": [
                "text"
              ],
              "constraint_type": 1
            },
            "properties_to_get": [
              "text"
            ],
            "tags_to_get": [
              {
                "type": 1,
                "key": "text"
              }
            ],
            "integration_types": [
              "text"
            ]
          }
        ],
        "nodes_operator": 0
      },
      "additional_spec_properties": {}
    }
  ],
  "page_size": "text",
  "page_token": "text"
}

{
  "value": {
    "id": "text",
    "state": 1,
    "status": 1,
    "error_status": {
      "code": 1,
      "message": "text",
      "details": [
        {
          "@type": "text",
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      ]
    },
    "error_reason": "text",
    "current_count": 1,
    "total_count": 1,
    "result_type": "text",
    "result": {
      "@type": "text",
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "started_at": "2026-02-19T20:46:37.966Z",
    "completed_at": "2026-02-19T20:46:37.966Z"
  }
}

Workflow

1. Submit the query using this endpoint. The request body uses the same GetAssessmentQuerySpecResultRequest as the synchronous endpoint.

2. The response includes an AsyncTask with an id field.

3. Poll the task status using GET /api/private/assessments/async_tasks/{id}.

4. When state = 3 (COMPLETE) and status = 1 (SUCCEEDED), the result field contains the query output.

AsyncTask state and status values

State (task lifecycle):

Value	Name	Description
0	UNKNOWN_STATE	Default/unset
1	PENDING	Queued, not yet started
2	IN_PROGRESS	Executing
3	COMPLETE	Finished (check status)

Status (outcome when complete):

Value	Name	Description
0	UNKNOWN_STATUS	Default/unset
1	SUCCEEDED	Result available
2	FAILED	See error_reason
3	CANCELED	Task was canceled

Migration note

Several fields on GetAssessmentQuerySpecResultRequest are deprecated. Use relates_to_exp instead of destination_node_types, required_intermediate_node_types, avoided_intermediate_node_types, raw_permissions, effective_permissions, and no_relation.