---
title: Inboxes
---

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

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `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 |  |
| `inboxes` | array\<object\> | Yes |  |
| `limit` | integer | Yes |  |
| `next_page_token` | string | No |  |

##### Example

```json
{
  "count": 0,
  "inboxes": [
    {
      "confirmed_at": "2026-01-01T00:00:00Z",
      "created_at": "2026-01-01T00:00:00Z",
      "email_address": "<string>",
      "enable_deep_backfill": true,
      "enable_semantic_search": true,
      "human_user_id": "<string>",
      "inbox_id": "<string>",
      "last_synced_at": "2026-01-01T00:00:00Z",
      "provider": "google_oauth",
      "status": "pending_confirmation",
      "updated_at": "2026-01-01T00:00:00Z"
    }
  ],
  "limit": 0,
  "next_page_token": "<string>"
}
```


## Delete Inbox
Agentry API endpoint.
**Endpoint**: `DELETE /human/v0/inboxes/{inbox_id}`
**Authentication**: `Authorization: Bearer <token>`
### Parameters

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

### Responses

#### `204`

Successful response


## Trigger Inbox Sync
Agentry API endpoint.
**Endpoint**: `POST /human/v0/inboxes/{inbox_id}/sync`
**Authentication**: `Authorization: Bearer <token>`
### Parameters

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

### Responses

#### `200`

Successful response

Content-Type: `application/json`

##### Fields

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `folders_processed` | integer | Yes |  |
| `inbox_id` | string | Yes |  |
| `messages_processed` | integer | Yes |  |

##### Example

```json
{
  "folders_processed": 0,
  "inbox_id": "<string>",
  "messages_processed": 0
}
```