---
title: AiThread type | Wartiva GraphQL API
description: Type AiThread represents a conversation thread between a user and the AI system, containing metadata about the thread's purpose, associated object.
url: https://wartiva.com/api-docs/types/ai-thread.html
updated: 2026-10-07
---

AI · GraphQL type

# `AiThread` type

Type `AiThread` represents a conversation thread between a user and the AI system, containing metadata about the thread's purpose, associated object, and activity timestamp.

## Fields

| Field Name | Description |
|---|---|
| `id` - [`AiThreadId!`](https://wartiva.com/api-docs/types/ai-thread-id.html) | The thread ID. |
| `name` - [`String!`](https://wartiva.com/api-docs/types/string.html) | The thread name. |
| `threadType` - [`AiThreadType!`](https://wartiva.com/api-docs/types/ai-thread-type.html) | The thread type. |
| `objectId` - [`String`](https://wartiva.com/api-docs/types/string.html) | The ID of the system object. |
| `entries` - [`[AiThreadEntry!]!`](https://wartiva.com/api-docs/types/ai-thread-entry.html) | Collection of AI thread entries. |
| `timestamp` - [`Time!`](https://wartiva.com/api-docs/types/time.html) | The time of the recent thread activity |

## Returned by

- [`aiThread`](https://wartiva.com/api-docs/queries/ai-thread.html) query: Retrieves one of the caller's AI chat threads with its messages.
- [`aiThreadClear`](https://wartiva.com/api-docs/queries/ai-thread-clear.html) query: Removes every message from one of the caller's AI chat threads and returns the now-empty thread.
- [`aiThreadCreate`](https://wartiva.com/api-docs/queries/ai-thread-create.html) query: Creates an AI chat thread of the requested type, or returns the existing one: a thread id is derived from the user, organization, thread type,…
- [`aiThreads`](https://wartiva.com/api-docs/queries/ai-threads.html) query: Lists the caller's AI chat threads in an organization that contain at least one message, most recently updated first.

## Used by

- [`AiThreadPayload`](https://wartiva.com/api-docs/types/ai-thread-payload.html) type: Type AiThreadPayload serves as a container for retrieving multiple AI threads.

## Related types

- [`AiThreadEntry`](https://wartiva.com/api-docs/types/ai-thread-entry.html) Type AiThreadEntry represents an individual message in an AI thread, acting as a base interface for different types of thread entries with common…

## Example

### Example

```json
{
  "id": AiThreadId,
  "name": "abc123",
  "threadType": "GENERAL",
  "objectId": "xyz789",
  "entries": [AiThreadEntry],
  "timestamp": "2021-10-07T18:23:25.829Z"
}

```

---

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