> ## Documentation Index
> Fetch the complete documentation index at: https://docs.standardagents.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Threads

Lists all threads, optionally filtered by agent or user.

**agent\_id** `string`

Filter threads by agent name

**user\_id** `string`

Filter threads by user identifier

**limit** `number` (default: 50)

Maximum number of threads to return (1-100)

**offset** `number` (default: 0)

Number of threads to skip for pagination

**threads** `array` *required*

Array of thread objects

**total** `number` *required*

Total number of threads matching the filter

**hasMore** `boolean` *required*

Whether more threads exist beyond the current page

### Thread Object

**threads\[].id** `string` *required*

Unique thread identifier

**threads\[].agent\_id** `string` *required*

The agent name associated with this thread

**threads\[].user\_id** `string | null`

User identifier if set

**threads\[].tags** `array` *required*

Array of string tags

**threads\[].created\_at** `number` *required*

Unix timestamp in seconds

**threads\[].agent** `object`

Agent details including title, type, description, and icon

**threads\[].agent.title** `string`

Human-readable agent title

**threads\[].agent.type** `string`

Agent type: `ai_human` or `dual_ai`

**threads\[].agent.description** `string`

Agent description if set

**threads\[].agent.icon** `string`

Full URL to agent icon (absolute paths are resolved to full URLs)

```bash cURL theme={null}
curl "https://your-worker.workers.dev/api/threads?user_id=user_abc123&limit=20"
```

```typescript JavaScript theme={null}
const response = await fetch(
  'https://your-worker.workers.dev/api/threads?user_id=user_abc123&limit=20'
);
const result = await response.json();
```

```json 200 theme={null}
{
  "threads": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "agent_id": "support_agent",
      "user_id": "user_abc123",
      "tags": ["support", "web"],
      "created_at": 1699900000,
      "agent": {
        "title": "Support Agent",
        "type": "ai_human",
        "description": "Handles customer inquiries and resolves support issues",
        "icon": "https://your-worker.workers.dev/icons/support.svg"
      }
    },
    {
      "id": "660e8400-e29b-41d4-a716-446655440001",
      "agent_id": "support_agent",
      "user_id": null,
      "tags": [],
      "created_at": 1699800000,
      "agent": {
        "title": "Support Agent",
        "type": "ai_human",
        "description": "Handles customer inquiries and resolves support issues",
        "icon": "https://your-worker.workers.dev/icons/support.svg"
      }
    }
  ],
  "total": 2,
  "hasMore": false
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.