---
title: Threads
---

## List Threads
Agentry API endpoint.
**Endpoint**: `GET /human/v0/threads`
**Authentication**: `Authorization: Bearer <token>`
### Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `inbox_id` | query | string | No |  |
| `limit` | query | integer | No |  |
| `page_token` | query | string | No |  |

### Responses

#### `200`

Successful response

Content-Type: `application/json`

##### Fields

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `count` | integer | Yes |  |
| `limit` | integer | Yes |  |
| `next_page_token` | string | No |  |
| `threads` | array\<object\> | Yes |  |

##### Example

```json
{
  "count": 0,
  "limit": 0,
  "next_page_token": "<string>",
  "threads": [
    {
      "inbox_id": "<string>",
      "latest_message_id": "<string>",
      "latest_message_received_at": "2026-01-01T00:00:00Z",
      "message_count": 0,
      "snippet": "<string>",
      "subject": "<string>",
      "thread_id": "<string>"
    }
  ]
}
```


## Get Thread
Agentry API endpoint.
**Endpoint**: `GET /human/v0/threads/{thread_id}`
**Authentication**: `Authorization: Bearer <token>`
### Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `thread_id` | path | string | Yes |  |

### Responses

#### `200`

Successful response

Content-Type: `application/json`

##### Fields

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `inbox_id` | string | Yes |  |
| `latest_message_id` | string | Yes |  |
| `latest_message_received_at` | string | No |  |
| `message_count` | integer | Yes |  |
| `messages` | array\<object\> | Yes |  |
| `snippet` | string | No |  |
| `subject` | string | No |  |
| `thread_id` | string | Yes |  |

##### Example

```json
{
  "inbox_id": "<string>",
  "latest_message_id": "<string>",
  "latest_message_received_at": "2026-01-01T00:00:00Z",
  "message_count": 0,
  "messages": [
    {
      "folder": "<string>",
      "from": "<string>",
      "inbox_id": "<string>",
      "message_id": "<string>",
      "message_id_header": "<string>",
      "received_at": "2026-01-01T00:00:00Z",
      "snippet": "<string>",
      "subject": "<string>",
      "uid": 0
    }
  ],
  "snippet": "<string>",
  "subject": "<string>",
  "thread_id": "<string>"
}
```