# REST Resource: users.threads

- [Resource: Thread](https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.threads#Thread)
  - [JSON representation](https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.threads#Thread.SCHEMA_REPRESENTATION)
- [Methods](https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.threads#METHODS_SUMMARY)

## Resource: Thread

A collection of messages representing a conversation.

| JSON representation |
|---|
| ``` { "id": string, "snippet": string, "historyId": string, "messages": [ { object (`https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.messages#Message`) } ] } ``` |

| Fields ||
|---|---|
| `id` | `string` The unique ID of the thread. |
| `snippet` | `string` A short part of the message text. |
| `historyId` | `string` The ID of the last history record that modified this thread. |
| `messages[]` | ``object (`https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.messages#Message`)`` The list of messages in the thread. |

| ## Methods ||
|---|---|
| ### `https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.threads/delete` | Immediately and permanently deletes the specified thread. |
| ### `https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.threads/get` | Gets the specified thread. |
| ### `https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.threads/list` | Lists the threads in the user's mailbox. |
| ### `https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.threads/modify` | Modifies the labels applied to the thread. |
| ### `https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.threads/trash` | Moves the specified thread to the trash. |
| ### `https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.threads/untrash` | Removes the specified thread from the trash. |