---
title: graphSearch query | Wartiva GraphQL API
description: Starts a search of an organization's security graph and returns the search job immediately, without waiting for results.
url: https://wartiva.com/api-docs/queries/graph-search.html
updated: 2026-10-07
---

Graph search · GraphQL query

# `graphSearch` query

Starts a search of an organization's security graph and returns the search job immediately, without waiting for results. A search selects objects of one type with a where clause, can follow relationships from them to related objects, and can be limited to a time range, which is clamped to the organization's data retention window. Poll the job with [graphSearchJob](https://wartiva.com/api-docs/queries/graph-search-job.html) and read rows with [graphSearchResults](https://wartiva.com/api-docs/queries/graph-search-results.html); stop it with [graphSearchJobCancel](https://wartiva.com/api-docs/mutations/graph-search-job-cancel.html). Clients that cannot poll can use [graphSearchFast](https://wartiva.com/api-docs/queries/graph-search-fast.html) for small result sets.

## Response

Returns a [`GraphSearchPayload!`](https://wartiva.com/api-docs/types/graph-search-payload.html)

## Arguments

| Name | Description |
|---|---|
| `input` - [`GraphSearchInput!`](https://wartiva.com/api-docs/types/graph-search-input.html) | The graph search input parameters. |

## Example

### Query

```graphql
query graphSearch($input: GraphSearchInput!) {
  graphSearch(input: $input) {
    searchJob {
      id
      orgId
      requestedInput {
        ...GraphSearchInputPayloadFragment
      }
      effectiveInput {
        ...GraphSearchInputPayloadFragment
      }
      hash
      user {
        ...UserFragment
      }
      state
      errors
      resultsCount
      hasResults
      startedAt
      endedAt
      running
      duration
      updatedAt
      accessedAt
      winningTrace {
        ...SearchTraceStageFragment
      }
      unselectedTraces {
        ...SearchTraceStageFragment
      }
    }
  }
}

```

### Variables

```json
{"input": GraphSearchInput}

```

### Response

```json
{"data": {"graphSearch": {"searchJob": GraphSearchJob}}}

```

---

Wartiva is in early access. Request access: https://wartiva.com/early-access.html  
All pages: https://wartiva.com/llms.txt