---
title: aiGenerateGraphQLQuery query | Wartiva GraphQL API
description: Asks the AI assistant to write a Wartiva GraphQL query from a natural-language request, for the object type the thread was created with (see aiThreadCreate).
url: https://wartiva.com/api-docs/queries/ai-generate-graphql-query.html
updated: 2026-10-07
---

AI · GraphQL query

# `aiGenerateGraphQLQuery` query

Asks the AI assistant to write a Wartiva GraphQL query from a natural-language request, for the object type the thread was created with (see [aiThreadCreate](https://wartiva.com/api-docs/queries/ai-thread-create.html)). Returns the assistant's message and the generated query. Each call clears the thread's earlier history before generating, so every request is answered on its own. Returns an error when the AI service is not available; check [aiStatus](https://wartiva.com/api-docs/queries/ai-status.html).

## Response

Returns an [`AiThreadEntry!`](https://wartiva.com/api-docs/types/ai-thread-entry.html)

## Arguments

| Name | Description |
|---|---|
| `threadId` - [`AiThreadId!`](https://wartiva.com/api-docs/types/ai-thread-id.html) | The thread ID. |
| `message` - [`String!`](https://wartiva.com/api-docs/types/string.html) | Natural language input to base the query generation on. |
| `aiModel` - [`AiModelInput`](https://wartiva.com/api-docs/types/ai-model-input.html) | Optionally specify AI model to utilize. |

## Example

### Query

```graphql
query aiGenerateGraphQLQuery(
  $threadId: AiThreadId!,
  $message: String!,
  $aiModel: AiModelInput
) {
  aiGenerateGraphQLQuery(
    threadId: $threadId,
    message: $message,
    aiModel: $aiModel
  ) {
    timestamp
    isFromUser
    message
  }
}

```

### Variables

```json
{
  "threadId": AiThreadId,
  "message": "xyz789",
  "aiModel": AiModelInput
}

```

### Response

```json
{
  "data": {
    "aiGenerateGraphQLQuery": {
      "timestamp": "2021-10-07T18:23:25.829Z",
      "isFromUser": false,
      "message": "abc123"
    }
  }
}

```

## Related operations

- [`aiGenerateSearchQuery`](https://wartiva.com/api-docs/queries/ai-generate-search-query.html) query: Asks the AI assistant to turn a natural-language request into a graph search query, such as "Windows endpoints with an unencrypted disk", that can…
- [`aiQueryObject`](https://wartiva.com/api-docs/queries/ai-query-object.html) query: Asks the AI assistant a natural-language question about the specific graph object the thread was created for (see aiThreadCreate with an object id).
- [`aiQuerySearch`](https://wartiva.com/api-docs/queries/ai-query-search.html) query: Asks the AI assistant a natural-language question that it answers by searching the security graph, for example "which endpoints have not reported in…
- [`aiThreadMessage`](https://wartiva.com/api-docs/queries/ai-thread-message.html) query: Sends a message to an AI chat thread and returns the assistant's reply.

---

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